今年的春节
注定是一个不一般的春节
没有热热闹闹的过年气氛
陪伴我们的只有冷冷清清的街道
以及不断刷新的疫情消息
从春节开始
疫情是每个人关心的重中之重
真希望,明天一睁眼
小N就能看到以下的好消息
· 火神山最后一位患者出院
· 各地援鄂人员平安返航
· 疫情结束了 口罩还在路上
· 各企业单位正式复工
· 今日全国累计治愈出院超过1000例
· 全国中小学开学时间
· 全国交通今日恢复正常
………………
小N相信,这一切都会很快实现!!
小N秉承“在家躺着也是做贡献”的深邃理念
天天在床上看疫情图数据
但宅在家里实在没事干
某日实在“技痒”
就研究了下如何制作这份疫情地图。
△(效果预览)
1
准备工作
1. 进入腾讯云控制台,在左上角云产品菜单里,选择【管理与审计】-> 【访问管理】,进入后在左边菜单栏中选择【访问密钥】->【API 密钥管理】,生成并获取一对 API 密钥。
???
2. 在电脑安装 Node.js
语言运行环境,建议大于 8.0 版本。
3. 安装 VS Code
以及 Tencent Serverless Toolkit
插件,或者安装命令行工具。
前者可参考文档:https://cloud.tencent.com/document/product/583/38106
后台可参考文档:https://cloud.tencent.com/document/product/583/33445
通过了解文档,或者本课程之前的章节,学习如何用VS Code
插件或命令行工具创建和上传云函数。
学习完后,请创建一个名为 yiqing
的云函数。
4. 用以下网址下载本课程的代码包,目录是 scr/yiqing,并将里面的代码覆盖刚才新创建的yiqing云函数中的文件。然后在该目录中命令行运行npm i,安装代码包的依赖。
https://github.com/lcxfs1991/tencentcloudcourse
2
任务一 补充云函数逻辑
在云函数yiqing
的index.js
文件中,根据步骤提示,补充以下的逻辑。其中值得注意的是,该云函数除了承担渲染 html 的能力,还承担了输出数据的能力,这完全是通过链接中的api
参数决定。通过这样的区别输出,就省了多制作一个云函数的麻烦,可谓是一举两得。
???
代码语言:javascript复制// 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 });
除此以外,由于后面创建网关的时候,要使用网关的集成响应,因此必须按照以下的格式对云函数进行输出,而不能直接返回一段数据。
代码语言:javascript复制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};
3
任务二 给模板补充逻辑
在云函数yiqing
的index.html
文件中,根据步骤提示,补充以下的逻辑。
// 1. 填充地图模板变量
let china_map = ${china_map} || null;
代码语言:javascript复制// 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}`);
代码语言:javascript复制// 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
};
});
代码语言:javascript复制// 4. 给疫情地图添加标题title: {
text: '疫情地图',
subtext: `${disease_data.lastUpdateTime} 更新`,
left: 'right'},
代码语言:javascript复制// 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人' }
],
代码语言:javascript复制// 6. 填写疫情地图的数据及悬浮框的展示信息
series: [
{
name: '确诊病例',
type: 'map',
roam: true,
map: 'china',
label: {
show: true
},
emphasis: {
label: {
show: true
}
},
data: confirmData
}
];
代码语言:javascript复制// 7. 定时拉取
setInterval(function() {
updateMap();
}, 60000);
需要简单说明的是,该模板是使用了EChart
的模板进行改造,模板地址如下:
https://www.echartsjs.com/examples/zh/editor.html?c=map-usa
下图是模板的效果。你也可以点击该模板右下角的Download
按钮将模板的html
文件下载下来,然后按自己的喜欢进行编辑改造。
完成模板的改造后,请用插件或者命令行工具,上传云函数。下图是通过VS Code
插件上传云函数的示例:
4
任务三 创建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
5
任务四 添加自定义域名
如果觉得网关提供的域名过长,又或者担心这种域名由于安全问题会被微信等大平台封禁,可以自己自行配置自定义域名。首先,在云函数yiqing
的控制台面板里,找到【触发方式】,然后点击任务三中添加过的触发器里的【API 服务名】,进入更详细的网关配置控制台。
进入【自定义域名】菜单,新建自定义域名,如果想配置 HTTPS 协议,则需要去申请 HTTPS 证书(腾讯云有免费的可以申请,可以跟着提示跳转到证书配置菜单)。
可以按照下图的示例进行配置。要注意的是,如果想访问的路径更扁平化一点,请选择“自定义路径映射”,路径填入/
,环境选择发布。如果不这样配置,如果原本网关的域名是:
https://service-lltf3zya-1253970226.gz.apigw.tencentcs.com/release/demo_yiqing
那么配置好之后,访问的路径就是:
https://yiqing.docschina.org/release/demo_yiqing
但如果配置了/
,那么后面的路径就只剩下demo_yiqing
了。
在保存配置信息之前,请首先在域名解析服务商,根据弹窗的提示,先把域名的 CNAME 配置好。比如这里使用的是下面的域名:
https://yiqing.docschina.org
提示要 CNAME 到service-lltf3zya-1253970226.gz.apigw.tencentcs.com.
。做完 CNAME 后,就可以保存自定义域名的添加配置。稍等片刻,就可以访问了。
如果看到配置列表上显示“解析成功”,那表明一切的陪着已经妥当,请尝试访问下面的网址进行体验吧~
https://yiqing.docschina.org/demo_yiqing
作为程序员
小N还是建议大家
“勤洗手、少出门”
多在家提升自我
等疫情过去,再一起出去嗨呀~
腾讯NEXT学院
求职干货 | 前辈blog | 前端课程