今年的春节
注定是一个不一般的春节
没有热热闹闹的过年气氛
陪伴我们的只有冷冷清清的街道
以及不断刷新的疫情消息
作为程序员的我,
希望也做点什么,为抗疫战做点贡献。
天天在床上看疫情图数据,
但宅在家里实在没事干,
某日实在“技痒”,
就参考着腾讯网的实时疫情页面,
研究了下如何制作这份疫情地图。
开始以为很难,结果发现用腾讯云云函数,居然1天就能上线!

制作疫情地图
准备工作
- 进入腾讯云控制台,在左上角云产品菜单里,选择【管理与审计】-> 【访问管理】,进入后在左边菜单栏中选择【访问密钥】->【API 密钥管理】,生成并获取一对 API 密钥。

-
在电脑安装
Node.js
语言运行环境,建议大于 8.0 版本。 -
安装
VS Code
+Tencent Serverless Toolkit
插件,或者安装命令行工具。
前者可参考文档:cloud.tencent.com/document/pr… 后台可参考文档:cloud.tencent.com/document/pr…
通过了解文档,或者本课程之前的章节,学习如何用VS Code
插件或命令行工具创建和上传云函数。
学习完后,请创建一个名为 yiqing
的云函数。
- 在github.com/lcxfs1991/t…下载本课程的代码包,目录是
scr/yiqing
,并将里面的代码覆盖刚才新创建的yiqing
云函数中的文件。然后在该目录中命令行运行npm i
,安装代码包的依赖。
效果预览

知识点
- 知道如何利用工具创建和上传云函数
- 知道如何创建
API
网关触发器 - 知道如何在云函数中部署能渲染
HTML
的服务 - EChart.js 的使用
任务一 补充云函数逻辑
在云函数yiqing
的index.js
文件中,根据步骤提示,补充以下的逻辑。其中值得注意的是,该云函数除了承担渲染 html 的能力,还承担了输出数据的能力,这完全是通过链接中的api
参数决定。通过这样的区别输出,就省了多制作一个云函数的麻烦,可谓是一举两得。
// 1. 接受链接上的query参数api,用于判断是输出html,还是输出数数
let api = event.queryString.api || false;
// 2. 请求疫情数据
let result = await axios.get(
`https://view.inews.qq.com/g2/getOnsInfo?name=disease_h5`
);
// 3. 中国地图数据
let china_map = JSON.stringify(require('./china.json'));
// 4. 解析并渲染 html 页面
let html = fs.readFileSync(path.resolve(__dirname, './index.html'), {
encoding: 'utf-8'
});
html = render(html, { disease_data: result.data.data, china_map });
除此以外,由于后面创建网关的时候,要使用网关的集成响应,因此必须按照以下的格式对云函数进行输出,而不能直接返回一段数据。
if (!api) {
return {
isBase64Encoded: false,
statusCode: 200,
headers: { 'Content-Type': 'text/html' },
body: html
};
}
// 5. 输出疫情数据
return {
isBase64Encoded: false,
statusCode: 200,
headers: { 'Content-Type': 'application/json' },
body: result.data.data
};
任务二 给模板补充逻辑
在云函数yiqing
的index.html
文件中,根据步骤提示,补充以下的逻辑。
// 1. 填充地图模板变量
let china_map = ${china_map} || null;
// 2. 填充确诊、疑似、治愈、死亡数据
let chinaTotal = disease_data.chinaTotal;
let chinaAdd = disease_data.chinaAdd;
$('.confirm .add span').html(`+${chinaAdd.confirm}`);
$('.suspect .add span').html(`+${chinaAdd.suspect}`);
$('.cure .add span').html(`+${chinaAdd.heal}`);
$('.dead .add span').html(`+${chinaAdd.dead}`);
$('.confirm .number').html(`${chinaTotal.confirm}`);
$('.suspect .number').html(`${chinaTotal.suspect}`);
$('.cure .number').html(`${chinaTotal.heal}`);
$('.dead .number').html(`${chinaTotal.dead}`);
// 3. 处理疫情地图中的确诊数据格式
/**
* 需要 {name: 'xxx', value: 'xxx'} 这样的格式
*/
let province = disease_data.areaTree[0].children;
let confirmData = province.map(function(item) {
return {
name: item.name,
value: item.total.confirm
};
});
// 4. 给疫情地图添加标题
title: {
text: '疫情地图',
subtext: `${disease_data.lastUpdateTime} 更新`,
left: 'right'
},
// 5. 添加数据分段
pieces: [
{ min: 10000, label: '10000人及以上' },
{ min: 1000, max: 9999, label: '1000-9999人' },
{ min: 500, max: 999, label: '500-999人' },
{ min: 100, max: 499, label: '100-499人' },
{ min: 10, max: 99, label: '10-99人' },
{ min: 1, max: 9, label: '1-9人' }
],
// 6. 填写疫情地图的数据及悬浮框的展示信息
series: [
{
name: '确诊病例',
type: 'map',
roam: true,
map: 'china',
label: {
show: true
},
emphasis: {
label: {
show: true
}
},
data: confirmData
}
];
// 7. 定时拉取
setInterval(function() {
updateMap();
}, 60000);
需要简单说明的是,该模板是使用了EChart
的模板进行改造,模板地址如下:www.echartsjs.com/examples/zh…,下图是模板的效果。你也可以点击该模板右下角的Download
按钮将模板的html
文件下载下来,然后按自己的喜欢进行编辑改造。

完成模板的改造后,请用插件或者命令行工具,上传云函数。下图是通过VS Code
插件上传云函数的示例:

任务三 创建 API 网关触发器
进入控制台,找到云函数的控制台,并选择云函数所在的地区以及命名空间,然后进入云函数的编辑界面,选择触发方式菜单,然后点击“添加触发方式”,按以下的内容添加一个 API 网关触发器。注意,请务必勾选“启用集成响应”,这样网关才能正确渲染HTML
的内容。

创建完毕后,可以 API 网关触发器中,拿到访问路径路径,在浏览器中进行访问。如果验证过没问题后,建议将云函数,通过VS Code
插件同步下来,将旧的template.yaml
文件替换掉,这样避免下次上传云函数的时候,生成重复的 API 网关触发器。只有像下面的Events
触发事件那样,将系统生成的网关贴上去,才不会重复生成新的网关,造成资源浪费。
Events:
service-8lqamcni:
Type: APIGW
Properties:
Enable: true
StageName: release
ServiceId:
HttpMethod: GET
IntegratedResponse: true
体验地址:疫情地图体验
任务四 添加自定义域名
如果觉得网关提供的域名过长,又或者担心这种域名由于安全问题会被微信等大平台封禁,可以自己自行配置自定义域名。首先,在云函数yiqing
的控制台面板里,找到【触发方式】,然后点击任务三中添加过的触发器里的【API 服务名】,进入更详细的网关配置控制台。

进入【自定义域名】菜单,新建自定义域名,如果想配置 HTTPS 协议,则需要去申请 HTTPS 证书(腾讯云有免费的可以申请,可以跟着提示跳转到证书配置菜单)。

可以按照下图的示例进行配置。要注意的是,如果想访问的路径更扁平化一点,请选择“自定义路径映射”,路径填入/
,环境选择发布。如果不这样配置,如果原本网关的域名是service-lltf3zya-1253970226.gz.apigw.tencentcs.com/release/dem…,那么配置好之后,访问的路径就是[yiqing.docschina.org/release/dem…]。但如果配置了/
,那么后面的路径就只剩下demo_yiqing
了。

在保存配置信息之前,请首先在域名解析服务商,根据弹窗的提示,先把域名的 CNAME 配置好。比如这里使用的是yiqing.docschina.org,域名,提示要 CNAME 到service-lltf3zya-1253970226.gz.apigw.tencentcs.com.
。做完 CNAME 后,就可以保存自定义域名的添加配置。稍等片刻,就可以访问了。

如果看到配置列表上显示“解析成功”,那表明一切的陪着已经妥当,请尝试访问:yiqing.docschina.org/demo_yiqing进行体验吧!