广东应急气象共享使用说明

一、数据接口调用规范

广东应急气象数据开放接口包括以下四类：天气实况数据接口、天气预报数据接口、预警信号数据接口和台风数据接口。

请求方式：http get

接口组成：由固定URL加4个不同的参数组成。

完整URL：http://open.gd121.cn/share/getData.do?type=””&code=””&productType=””&key="“

固定URL：http://open.gd121.cn/share/getData.do

参数说明：

1）productType：气象数据，具体为

LIVE：实况数据

YJ：预警数据

FCST：预报数据

TF：台风数据

注：区分大小写

2）type：数据返回格式，包括xml和json格式；注：区分大小写

3）code：城市区域码，如广州 440100。

4）key：产品key，用户认证通过后，获取到的产品密钥，每一种产品对应一个产品key。

示例：

实况：

http://open.gd121.cn/share/getData.do?type=xml&code=440200&productType=LIVE&key=0b9fdcc756a60ea59f82aa3a

注：该链接中的key为测试key。

二、预警、天气插件使用方法

预警插件：

1)支持选择21个地市；

2)预警支持到县；

3)多条预警自动翻滚显示；

4)鼠标停留即显示该地区全部预警；

5)自定义高度、宽度；

6)标题颜色、背景色等可选。

天气插件：

1)支持选择21个地市；

2)可选择横向、纵向样式；

3)提供天气实况、空气质量、预警、5天预报等；

4)鼠标停留即显示该地区5天预报详情；

5)预警支持到县；

6)自定义高度、宽度；

7)颜色、背景色等可选。

使用方法：

1)选择插件样式；

2)个性化属性定制，点击下一步；

3)获取插件代码和相应的js代码；

4)拷贝插件代码，放入您的网页HTML的合适位置，并在该网页引入js代码。

数据更新频率表

数据类型	更新频率
实况	每小时15分更新
预报	每30分钟更新一次
预警	每5分钟更新一次
台风	每1小时更新一次

天气实况数据接口

广东省136个市（县、区）气象站的常规气象数据（温度、湿度、风力、风向、雨量、气压数据）

1.数据内容：

（1）常规要素：发布时间、实况日期时间，温度、湿度、风力、风向、雨量、气压数据。

（2）更新频次1小时1次。

2.气象信息服务内容说明：

此类为基础公众服务气象信息，是代表广东省气象局社会化发展的基本气象服务内容，对所有正规企业、开发者提供。使用方业务须标注信息来源、发布时间等，注明“广东应急气象”标识，提供“广东应急气象网”回链http://www.gd121.cn/，如需获取更多气象数据信息请联系广东省气象公共服务中心。

3.本共享服务免费。

天气预报数据接口

广东省136个市（县、区）气象站的3天天气预报数据

1.数据内容：

（1）常规预报要素：发布时间、预报日期时间、天气现象描述，最高/最低温度、风向、风力。

（2）3天常规预报更新频率:每30分钟更新一次。

2.气象信息服务内容说明：

此类为基础公众服务气象信息，是代表广东省气象局社会化发展的基本气象服务内容，对所有正规企业、开发者提供。使用方业务须标注信息来源、发布时间等，注明“广东应急气象”标识，提供“广东应急气象网”回链http://www.gd121.cn/，如需获取更多气象数据信息请联系广东省气象公共服务中心。

3.本共享服务免费。

预警信号数据接口

广东省内所有发布预警信号的市（县、区）气象局发布的适时预警信号，即时提供

1.数据内容：

广东省内所有发布预警信号的市（县、区）气象局发布的适时预警信号，即时提供。

2.气象信息服务内容说明：

此类为基础公众服务气象信息，是代表广东省气象局社会化发展的基本气象服务内容，对所有正规企业、开发者提供。使用方业务须标注信息来源、发布时间等，注明“广东应急气象”标识，提供“广东应急气象网”回链http://www.gd121.cn/，如需获取更多气象数据信息请联系广东省气象公共服务中心。

3.本共享服务免费。

台风数据接口

影响广东省的台风最新位置、路径和强度预报，即时提供。

1.数据内容：

影响广东省的台风最新位置（中央气象台定位）、路径和强度预报（广东省气象台预报），即时提供。

2.气象信息服务内容说明：

此类为基础公众服务气象信息，是代表广东省气象局社会化发展的基本气象服务内容，对所有正规企业、开发者提供。使用方业务须标注信息来源、发布时间等，注明“广东应急气象”标识，提供“广东应急气象网”回链http://www.gd121.cn/，如需获取更多气象数据信息请联系广东省气象公共服务中心。

3.本共享服务免费。

预警插件

广东省内所有发布预警信号的市（县、区）气象局发布的适时预警信号，即时提供

1.插件功能

1)支持选择21个地市；

2)预警支持到县；

3)多条预警自动翻滚显示；

4)鼠标停留即显示该地区全部预警；

5)自定义高度、宽度；

6)标题颜色、背景色等可选。

2.使用方法

1)选择插件样式；

2)个性化属性定制，点击下一步；

3)获取插件代码和相应的js代码；

4)拷贝插件代码，放入您的网页HTML的合适位置，并在该网页引入js代码。

天气插件

广东省内所有发布天气实况、天气预报、预警信号的市（县、区）气象局发布的适时预警信号，即时提供

1.插件功能

1)支持选择21个地市；

2)可选择横向、纵向样式；

3)提供天气实况、空气质量、预警、5天预报等；

4)鼠标停留即显示该地区5天预报详情；

5)预警支持到县；

6)自定义高度、宽度；

7)颜色、背景色等可选。

2.使用方法

1)选择插件样式；

2)个性化属性定制，点击下一步；

3)获取插件代码和相应的js代码；

4)拷贝插件代码，放入您的网页HTML的合适位置，并在该网页引入js代码。

城市编码表

城市	区域码	城市	区域码
广州	440100	梅州	441400
韶关	440200	汕尾	441500
深圳	440300	河源	441600
珠海	440400	阳江	441700
汕头	440500	清远	441800
佛山	440600	东莞	441900
江门	440700	中山	442000
湛江	440800	潮州	445100
茂名	440900	揭阳	445200
肇庆	441200	云浮	445300
惠州	441300

实况字段

字段名	字段说明
r	区域编码
n	区域名称
sk_s	天气状态
sk_t	温度
sk_h	相对湿度
sk_p	气压
sk_r1h	一小时降雨量
sk_i	天气图标
sk_time	实况时间
sk_wd	风向（度）
sk_wp	风速（米/秒）
sk_wp_level	风速等级
pm_aqi	AQI
pm_pm25	PM2.5

台风字段

字段名	字段说明
fcid	发布台代号
ddatetime	时间
tcid	国际编号
tcrank	台风等级
latitude	纬度
longitude	经度
windspeed	风速
crttime	入库时间
pressure	中心气压

预报字段

字段名	字段说明
r	区域编码
n	区域名称
f_dt	预报时间
f_rows	七天预报
wd	风向
ws	风速（级）
t	温度
s	天气状况
h	相对湿度
i	天气图标

预警字段

字段名	字段说明	字段名	字段说明
DDATETIME	资料时间	BBCC	编报中心
FBCC	发布站名	RTIME	收到时间
ITIME	入库时间	C_BDATE	编报日期（年月日）
V_BHM	编报时分	C_FDATE	预警发布日期（年月日）
C_FYYYY	预警发布年	C_FMM	预警发布月
C_FDD	预警发布日	V_FHM	预警发布时间（时分）
V06001	预警站号经度	V05001	预警站号纬度
V_TFLEV	台风预警级别	C_TFSTA	台风预警状态
C_TFCLT	台风预警解除时间（年月日时分）	V_BYLEV	暴雨预警级别
C_BYSTA	暴雨预警状态	C_BYCLT	暴雨预警解除时间
V_GWLEV	高温预警级别	C_GWSTA	高温预警状态
C_GWCLT	高温预警解除时间	V_HLLEV	寒冷预警级别
C_HLSTA	寒冷预警状态	C_HLCLT	寒冷预警解除时间
V_DWLEV	大雾预警级别	C_DWSTA	大雾预警状态
C_DWCLT	大雾预警解除时间	V_HMLEV	灰霾预警级别
C_HMSTA	灰霾预警状态	V_LYLEV	雷雨大风预警级别
C_LYSTA	雷雨大风预警状态	C_LYCLT	雷雨大风预警解除时间
V_JBLEV	道路结冰预警级别	C_JBSTA	道路结冰预警状态
C_JBCLT	道路结冰预警解除时间	V_BBLEV	冰雹预警级别
C_BBSTA	冰雹预警状态	C_BBCLT	冰雹预警解除时间
V_SLLEV	森林火险预警级别	C_SLSTA	森林火险预警状态
C_SLCLT	森林火险预警解除时间	CRTTIME	入库时间
KEYID	记录序号	sync_rowid	同步序号

气象信息服务单位备案

1.在线申报平台地址：http://www.gdzwfw.gov.cn/portal/guide/1210000000694109842442042001000

2.气象信息服务企业用户在填写相关信息后，可注册网上用户进行登录。注册完成后，可在线登录系统，查询气象信息服务企业备案信息和相关信用记录。

3.用户登录后，点击页面右上角办事大厅，进入用户申报管理页面，或直接点击在线申报，进入快捷申报通道。

4.网上备案申请成功，经气象局后台人员审核后，相关备案信息可在查询页面显示详情。或登陆广东省气象局官网--政务公开--公示公告一栏查看广东省气象信息服务单位备案公示结果。

更详细的操作指南请下载《用户手册》查看