- 1年
- 详细介绍
- 使用说明
数据说明
中国气象局面向社会媒体、企业开放气象服务数据,包含全国2400+个县级站点的3天预报、预警数据。数据调用方式为API接口调用。
数据要素说明
预报:天气现象、温度、风力、风向
预警:台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、霾、道路结冰、寒冷、灰霾、雷电大风、森林火险、降温、道路冰雪、干热风、低温、冰冻
产品使用概述
产品通过http get方式请求,请求接口由固定URL加3类参数组成,完整URL需客户端经过固定方式加密后使用。
接口请求规则
接口URL:
http://api.weatherdt.com/common/?area=站点ID&type=天气数据大类[数据小类]&key=ff6b1431cc0b3653d980147aed7b95c1。参数分别为请求时间站表ID(area)、天气数据大类(type)和密钥(key)。
站点ID(area)规则:
站点地区为国内站点。接口支持单站点请求和多站点请求,若为单站点请求,则在接口中只传入一个站点ID作为参数,若为多站点请求,则在接口中用“|”分隔拼接站点ID作为参数,一次最多拼接20个站表ID,且拼接的站点ID必须为同一地区站点,否则接口无效。站点ID见附件文档。
单站点示例:URL= http://api.weatherdt.com/common/?area=areaId&type=[天气数据大类]&key=ff6b1431cc0b3653d980147aed7b95c1
多站点示例:URL= http://api.weatherdt.com/common/?area=areaId|areaId&type=[天气数据大]&key=ff6b1431cc0b3653d980147aed7b95c1
天气数据大类(type)规则:
1)天气数据大类:预报(forecast)
接口错误编码:
错误编码 | 释义 |
---|---|
CC1000 | URL格式错误 |
CC1001 | area拼写错误 |
CC1002 | type拼写错误 |
CC1003 | key拼写错误 |
CC1004 | 站点多类型访问,站点个数多于20个形式访问 |
CC1005 | 密钥长度错误 |
CC1100 | 连接超时 |
CC1101 | 密钥错误 |
CC1102 | 用户接口失效 |
CC1103 | 系统无响应 |
CC1200 | 请求未定制区域数据 |
CC1300 | 要素错误 |
CC1301 | 请求未定制类型数据 |