本项目起初试图采用basemap进行地图绘制，在实践中发现basemap无法对同一地图实例进行重定位。然而basemap地图实例初始化、读入shapefile时间长，在无法复用地图实例的情况下，难以满足性能需求。
故目前采用openlayers进行地图渲染，并采用Chrome Headless进行截图，在复用浏览器实例的情况下，可以将成品图生成时间降低到 1s 内。
高亮城市
GET /Map/highlight
对中国大陆的城市进行高亮标识。
参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| center | string | 作为地图中心的省份名 |
| cities | string[] | 需要高亮的城市 |
对任何含有省份或城市名的参数，请使用完整官方名称。
支持省份
| # | 省名 |
|---|---|
| 1 | 浙江省 |
| 2 | 上海市 |
| 3 | 江苏省 |
☆ 对于直辖市无法细分
未来可能支持更多。
由于地图数据政治不正确，我们无法对西南某些省份提供支持。对于这些省份，返回HTTP 451。
示例
GET /Map/highlight?center=浙江省&cities=["杭州市", "宁波市"]
震度速报
POST /Map/shindo_early_report
参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| shindo | object | 震度信息 |
对 shindo 参数详细定义如下：
const shindo = {
"1": ["震度1的地区"],
"2": ["震度2的地区"],
"3": ["震度3的地区"],
"4": ["震度4的地区"],
"5-": ["震度5-的地区"],
"5+": ["震度5+的地区"],
"6-": ["震度6-的地区"],
"6+": ["震度6+的地区"],
"7": ["震度7的地区"],
}其中地区名按照 JMA 震度速报规范规定的地域名填写。
- 数字使用全角数字。例如：
東京都２３区。
预览
各地区震度信息
POST /Map/shindo_report
参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| epicenter | number[] | 震中经纬度 |
| shindo | object | 震度信息 |
定义同上
震中经纬度epicenter应为两个浮点数组成的数组。示例：[140.113, 23.019]。
其中地区名按照 JMA 各地区震度信息规范规定的地域名填写。
相关规范请参考：
地震火山関連コード表.xls -> Sheet 24 (AreaForecastLocalE ・ AreaInformationCity ・ PointSeismicIntensity コード表)
预览
海啸警报
POST /Map/tsunami_warning
参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| type | string | 类型 |
| warning | object | 警报信息 |
类型固定为warning（警报发布或更新）或者cancel（取消）。值为cancel时会忽略warning参数的内容。
对警报信息详细定义如下
const warning = {
"notice": ["京都府"], // 海啸注意报的区域
"warning": ["有明・八代海"], // 海啸警报的区域
"alert": ["千葉県九十九里・外房"] // 大海啸警报的区域
}其中区域名按照 JMA 规定的海啸警报区域名填写。
预览
台风路径信息
POST /Map/typhoon_info
参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| typhoon_info | object | 台风信息 |
对typhoon_info定义如下：
interface TyphoonInfo {
/** 特殊状态文本，如台风消散等 */
remark?: string;
/** 台风路径点合集，当remark有值时被忽略 */
points?: Point[];
}
interface Point {
/** 路径点类型 1: 历史路径点, 2: 当前路径点, 3: 预报路径点 */
type: number;
/** 坐标经纬度，格式为[东经, 北纬]，负值相应表示西经和南纬 */
coordinate: [number, number];
/** 台风强度 1: 热带风暴, 2: 强热带风暴, 3: 台风, 4: 强台风, 5: 超强台风 */
intensity: number;
/** 当前路径点上的范围信息 */
circles?: Circle[];
}
interface Circle {
/** 范围类型 1: 强风域, 2: 暴风域 */
type: number;
/** 半径，单位为米 */
radius: number;
/**
* 方向 1: 全域, 2: 北, 3: 东北, 4: 东, 5: 东南, 6: 南, 7: 西南, 8: 西, 9: 西北
* 1 为整圆 其余为半圆
*/
direction: number;
}预览
我们感谢 @9SQ 开源的震度图生产样例及坐标数据。（ https://github.com/9SQ/seismic-intensity-map ）
We would like to give a special thank to seismic intensity map demo and geographic coordinates which is open sourced by @9SQ.
我们同样需要感谢 Gehirn 和他们旗下的社交网络账号 @UN_NERV 为我们提供了参考和灵感。
Thanks for Gehirn Inc., and their SNS account @UN_NERV who provide much references and inspiration for us.