产品概述

简介

    中国天气气象数据集市隶属于北京天译科技有限公司,是中国天气网面向网络媒体、第三方气象服务机构等用户,通过API接口方式提供气象数据服务的官方载体。随着中国天气数据集市的逐渐完善,会面向广大用户提供更为丰富全面的气象数据,从而满足不同用户的不同需求。 用户通过中国天气气象数据集市的定制数据,自由选择想要全国4万多个县、乡镇站点,全球18万个城市站点,自由选择目前六大气象产品中的任意要素,预报时长,以及更新频率,方便直观。

    气象数据集市面向公众还有几款套餐供大家选择,目前有免费套餐,国内套餐,国内旅游套餐,国外套餐,国外旅游套餐,中国天气气象数据集市陆续还有更多不同的套餐来服务大众。 中国天气气象数据集市自运营以来,陆续和国内知名企业建立了合作伙伴关系,其中腾讯,奇虎360, 百度等国内一线互联网公司有长期的业务合作,也有为新创公司提供天气方面数据支持,如阿里妈妈,去滑雪GOSKI等。 中国天气气象数据集市即是普通天气应用爱好者的首选开发平台,也是社会各行各业开拓天气价值,提升服务质量, 促进本行业更好地发展的一个不错的选择。

产品特色

中国天气数据集市涉及的数据品类包括预报,实况,预警,空气质量,指数,图形产品,格点数据等,类型丰富。数据来源权威,使用方式简单便捷,跨平台。

应用场景

网站全国城市天气预报,天气预报服务性的APP应用,电视盒子天气预报应用,游戏场景和天气结合,农业灾害预防,保险行业和天气结合,医疗单位和疾病防治中心和天气服务结合提升优化服务质量,单车出行应用服务用户出行。

服务电话

商务电话:010-58993170

技术支持电话:010-58993905

使用说明

使用流程

注册申请数据集市帐号

登录数据集市官方网站http://www.weatherdt.com,点击右上角“注册”按钮进行注册并激活帐号,如下图所示:

选购数据

进入【价格】页面,根据需要进入不同的购买页面,如下图所示:

开发指南

接口URL

http://api.weatherdt.com/common/?area=站表ID...&type=天气数据大类[数据小类]&key=741c428fc7116c6f718cb14f2dda49sm

站点拼装规则

http://api.weatherdt.com/common/?area=站表ID...&type=天气数据大类[数据小类]&key=741c428fc7116c6f718cb14f2dda49sm

单站点

请求URL: http://api.weatherdt.com/common/?area=[站表ID]&type=[天气数据大类] &key=741c428fc7116c6f718cb14f2dda49sm

多站点

站点类型只能是4种类型的1种(中国站点,国外站点,旅游景点,机场),不能混,混着请求报错

站点数量N(2<=N<=20),超出范围报错

请求URL: http://api.weatherdt.com/common/?area=areaId|areaId&type=[天气数据大类] &key=741c428fc7116c6f718cb14f2dda49sm

要素拼装规则

单站点请求可以请求所有数据大类全部要素(推荐方式,简洁)

http://api.weatherdt.com/common/?area=areaId&type=index&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId&type=index|forcast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

单站点请求可以请求5个数据大类中的单个或多个元素(灵活方式,规则繁琐)

http://api.weatherdt.com/common/?area=areaId&type=index[1h_2d{001}] &key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId&type=index[1h_2d{001,002}]|forcast[1h_2d{001,002,003}]&key=741c428fc7116c6f718cb14f2dda49sm

多站点请求对于指数只能取一个要素,标出频次,时长,要素编码

http://api.weatherdt.com/common/?area=areaId|areaId&type=index[1h_2d{001}]&key=741c428fc7116c6f718cb14f2dda49sm

多站点请求可以请求除指数外所有数据大类全部要素

http://api.weatherdt.com/common/?area=areaId|areaId&type=alarm&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId|areaId&type=air|forcast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

多站点请求可以请求除指数外所有数据大类中的单个或多个元素

http://api.weatherdt.com/common/?area=areaId|areaId&type=air[001]&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId&type=air[001,004]|forcast[1h_2d{001,002,003}]&key=741c428fc7116c6f718cb14f2dda49sm

请求带有预报频次和预报时长的URL

http://api.weatherdt.com/common/?area=areaId&type=forcast[1h_2d{001, 002};3h_5d{001,002}]|index[1h_2d{001,002};3h_6d{001,002}]

参数说明

参数是否必须示例说明
area必须10010101001|10010101002站号,多个之间使用|分隔,最多支持20个站号
type必须forecast|alarm|air|observe或者index|forecast[1h_2d{001,002}]请求数据类型,多个大类之间使用|分隔,大类后可跟具体要素
key必须741c428fc7116c6f718cb14f2dda49sm密钥,与订单对应

接口错误编码表

编码错误说明备注
CC1000参数错误检查参数拼写
CC1003订单过期请重新购买服务
CC1004访问次数超限请合理访问接口
CC1005站点数过多错误单次访问请少于20个站点
CC1006访问接口路径错误访问接口路径错误
CC1100连接超时请稍后访问
CC1101密钥错误检查密钥
CC1102系统无响应请稍后访问
CC1200请求无效站点错误检查请求站点
CC1201请求站点与要素过多错误检查站点数量或要素数量
CC1300请求要素格式错误检查要素请求格式
CC1301请求未定制类型数据检查定制类型数据
CC1302请求类型定制天数超出错误检查请求类型的定制天数
CC1303请求多站点与指数多要素错误检查站点数量或指数要素数量

接口返回JSON示例

				

{

"air": {//空气质量

"101010100": {//站号

"2001006": {//数据大类

"006": "2.0",//SO2

"007": "32.0",//CO

"003": "65.0",//NO2

"004": "2.0",//O3

"000": "201611041000",//更新时间

"001": "290.0",//PM2.5

"005": "166.0",//PM10

"002": "290.0"//AQI

}

}

},

"alarm": {//预警

"101010100": {//站号

"1001003": [//数据大类

{

"006": "02",//预警级别编号

"010": "201611032200545111大雾黄色",//预警信息

"008": "2016-11-03 22:00",//预警发布时间

"011": "10101-20161103220000-1202.html",//天气网跳转地址

"009": "北京市气象台03日22时00分发布大雾黄色预警,预计当前至4日10时左右本市有雾,部分地区能见度小于500米,请注意防范。",//预警发布内容

"001": "北京市",//预警发布单位的省级名称

"005": "大雾",//预警类别名称

"004": "12",//预警类别编号

"003": "",//预警发布单位的县级名称

"007": "黄色",//预警级别名称

"002": ""//预警发布单位的市级名称

},

{

"006": "03",//预警级别编号

"010": "201611031750545111霾橙色",//预警信息

"008": "2016-11-03 17:50",//预警发布时间

"011": "10101-20161103175000-1303.html",//天气网跳转地址

"009": "北京市气象台03日17时50分更新发布霾橙色预警,预计3日夜间至4日,本市将出现中度到重度霾,能见度低,请注意防范。",//预警发布内容

"001": "北京市",//预警发布单位的省级名称

"005": "霾",//预警类别名称

"004": "13",//预警类别编号

"003": "",//预警发布单位的县级名称

"007": "橙色",//预警级别名称

"002": ""//预警发布单位的市级名称

}

]

}

},

"forecast": {//预报

"24h": {//逐24小时

"101010100": {//站号

"1001001": [//数据大类

{

"006": "0",//晚上风力

"008": "0",//晚上方向

"007": "0",//白天方向

"003": "15",//白天温度

"004": "4",//晚上温度

"001": "53",//白天天气现象编码

"005": "0",//白天风力

"002": "53"//晚上天气现象编码

},

{

"006": "0",//晚上风力

"008": "0",//晚上方向

"007": "0",//白天方向

"003": "17",//白天温度

"004": "3",//晚上温度

"001": "01",//白天天气现象编码

"005": "0",//白天风力

"002": "02"//晚上天气现象编码

},

{

"006": "0",//晚上风力

"008": "0",//晚上方向

"007": "0",//白天方向

"003": "10",//白天温度

"004": "4",//晚上温度

"001": "02",//白天天气现象编码

"005": "0",//白天风力

"002": "07"//晚上天气现象编码

}

],

"000": "201611040800"//更新时间

}

}

},

"observe": {//实况

"101010100": {//站号

"1001002": {//数据大类

"006": "0",//当前降水量(单位是毫米)

"007": "1004",//当前气压(单位百帕)

"003": "1",//当前风力(单位是级,不用转码)

"004": "2",//当前风向编号

"000": "10:25",//实况发布时间

"005": "79",//当前湿度(单位%)

"002": "7"//当前温度(单位摄氏度)

}

}

},

"index": {//指数

"24h": {//逐24小时

"101010100": {//站号

"1001004": [//数据大类

{

"002": {

"002002": "较冷",//指数等级

"002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。",//指数释义

"002001": "穿衣指数"//指数名称

},

"000": "20161104",

"005": {

"005001": "交通指数",//指数名称

"005003": "天气较好,但能见度很低,交通气象条件很差,车辆行驶缓慢,尽量减少出行。",//指数释义

"005002": "很差"//指数等级

},

"004": {

"004001": "感冒指数",//指数名称

"004003": "昼夜温差大,且空气湿度较大,易发生感冒,请注意适当增减衣服,加强自我防护避免感冒。",//指数释义

"004002": "易发"//指数等级

}

},

{

"002": {

"002002": "较冷",//指数等级

"002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。",//指数释义

"002001": "穿衣指数"//指数名称

},

"000": "20161105",

"005": {

"005001": "交通指数",//指数名称

"005003": "天气较好,路面干燥,交通气象条件良好,车辆可以正常行驶。",//指数释义

"005002": "良好"//指数等级

},

"004": {

"004001": "感冒指数",//指数名称

"004003": "昼夜温差很大,易发生感冒,请注意适当增减衣服,加强自我防护避免感冒。",//指数释义

"004002": "易发"//指数等级

}

},

{

"002": {

"002002": "较冷",//指数等级

"002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。",//指数释义

"002001": "穿衣指数"//指数名称

},

"000": "20161106",

"005": {

"005001": "交通指数",//指数名称

"005003": "阴天,路面干燥,交通气象条件良好,车辆可以正常行驶。",//指数释义

"005002": "良好"//指数等级

},

"004": {

"004001": "感冒指数",//指数名称

"004003": "各项气象条件适宜,无明显降温过程,发生感冒机率较低。",//指数释义

"004002": "少发"//指数等级

}

}

],

"000": "201611040800"//更新时间

}

}

}

}

数据编码

产品大类编码表

编码 中文名称 英文名称
001预报forecast
002实况observe
003预警alarm
004指数index
006空气质量air

数据频率表

数据类型更新频率
常规预报每天发布3次 发布时间分别为:08时、12时、18时
实况每小时更新一次
预警不定期更新,为保证预警的时效性,建议程序启动后每隔10分钟进行一次轮循
指数每天发布3次 发布时间分别为:08时、12时、18时
空气质量每小时更新一次

风向编号表

风向编号中文名称英文名称
0无持续风向No wind
1东北风Northeast
2东风East
3东南风Southeast
4南风South
5西南风Southwest
6西风West
7西北风Northwest
8北风North
9旋转风Whirl wind

风力编号表

风力编号中文名称英文名称
0微风<5.4m/s
13-4级5.5~7.9m/s
24-5级8.0~10.7m/s
35-6级10.8~13.8m/s
46-7级13.9~17.1m/s
57-8级17.2~20.7m/s
68-9级20.8~24.4m/s
79-10级24.5~28.4m/s
810-11级28.5~32.6m/s
911-12级32.7~36.9m/s

天气现象编码表

天气现象编码中文名称英文名称
0Sunny
1多云Cloudy
2Overcast
3阵雨Shower
4雷阵雨Thundershower
5雷阵雨伴有冰雹Thundershower with hail
6雨夹雪Sleet
7小雨Light rain
8中雨Moderate rain
9大雨Heavy rain
10暴雨Storm
11大暴雨Heavy storm
12特大暴雨Severe storm
13阵雪Snow flurry
14小雪Light snow
15中雪Moderate snow
16大雪Heavy snow
17暴雪Snowstorm
18Foggy
19冻雨Ice rain
20沙尘暴Duststorm
21小到中雨Light to moderate rain
22中到大雨Moderate to heavy rain
23大到暴雨Heavy rain to storm
24暴雨到大暴雨Storm to heavy storm
25大暴雨到特大暴雨Heavy to severe storm
26小到中雪Light to moderate snow
27中到大雪Moderate to heavy snow
28大到暴雪Heavy snow to snowstorm
29浮尘Dust
30扬沙Sand
31强沙尘暴Sandstorm
53Haze
99Unknown

代码示例

js请求代码示例(域名)

            	

$.ajax({

url:'http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX',

type : 'post',

cache : false,

dataType : 'jsonp',

success : function(data) {

for (var obj in data.forecast){

alert(obj);

}

}

});

php请求代码示例(ip)

            	

<?php

$url='http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX';

$resultJson=file_get_contents($url);

echo $resultJson;

?>

JAVA请求代码示例(ip)

            	

URL url = new URL("http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX");

HttpURLConnection uRLConnection = (HttpURLConnection)url.openConnection();

uRLConnection.setDoOutput(true);

uRLConnection.connect();

InputStream is = uRLConnection.getInputStream();

BufferedReader br = new BufferedReader(new InputStreamReader(is));

String respJson = "";

String readLine = null;

while((readLine =br.readLine()) != null){

respJson +=readLine;

}

is.close();

br.close();

uRLConnection.disconnect();

C#请求代码示例(域名)

            	

string url = "http://api.weatherdt.com/common/?area=101010100|101010200&type=forecast&key="XXXXXXXX";

Uri httpURL = new Uri(url,true);

HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create(httpURL);

HttpWebResponse httpResp = (HttpWebResponse)httpReq.GetResponse();

Stream respStream = httpResp.GetResponseStream();

StreamReader respStreamReader = new StreamReader(respStream, Encoding.UTF8);

string jsonContent=respStreamReader.ReadToEnd();

Console.WriteLine(jsonContent);

下载文档

天气产品要素编码下载  点击下载>>

接口使用文档下载  点击下载>>

天气图标下载  点击下载>>

图形产品文档

接口URL

http://api.weatherdt.com/pic/?area=101&type=1001&date=20160822&key=613e381aa0e0c9d377e2bce4cf14db87

area:地区,(101)全国

type:图片类型,只能请求一种类型

date:图片日期,形式(YYYYMMDD)

key:密钥

产品返回json串说明

				

{

"date":"20160822",//日期

"pictype":”1001",//图形产品类型

"content":[//图片地址和时间

{

"picurl":"",//图片地址

"time":"201600820080002400"//图片日期

},

{

"picurl":"",//图片地址

"time":"201600820080004800"//图片日期

}]

}

接口错误编码表

编码错误说明备注
CC1000参数错误检查参数拼写
CC1100连接超时请稍后访问
CC1101密钥错误检查密钥
CC1102访问日期超出订购日期范围访问日期超出订购日期范围
CC1103缓存已过期缓存已过期
CC1200请求无效站点错误检查请求站点
CC1300请求未定制类型数据请求未定制类型数据

常见问题

Q:哪里可以下载使用文档?

A:用户中心【订单管理】,【我的订单】,【接口详情】中,点击链接在新的页面下载购买的站号,要素,以及使用说明文档。

Q:可以续费或者在原订单里增加要素和站点吗?

A:用户中心【订单管理】,【我的订单】中点击订单变更或者订单续费,增加要素和站点只能使用订单变更功能

Q:预报和指数参数接口怎么传?

A:预报和指数因为有频次(逐小时,逐3小时,逐12小时,逐24小时)和时长(2d,3d,4d),所以预报和指数获取指定要素时,得有频次和时长,例:type=forecast[1h_2d{001,002};3h_5d{001,002}]|index[{1h_2d{001,002}}];不指定时,可以全部获取,例:type=forecast|index。

Q:怎样查看自己的key?

A:有两种方式:一种是在用户中心【订单管理】,【我的订单】,【接口详情】查看;一种是【订单管理】,【我的订单】中的产品名称列,点击国内站点,弹出详情,就可看到密钥。

接口调试

发送
参数 返回结果
type:forecast
area:101160901|101160801
key:fd034bf8fe70289698ec4ea79876feaa

意见反馈

工作时间9:00-18:00,请留下您的联系方式我们会尽快给您答复。

名称
邮箱
电话
问题类型