天气预报 官方自营 部分收费

 

数据来源于国家气象局发布的数据,可根据地区名称、经纬度、IP查询对应地区的天气预报。 包括天气预警、白天晚上的温度、湿度、风速、风力,一氧化碳、二氧化氮等PM 2.5空气质量指数,穿衣、出行、洗车等生活指数。7天天气范围的预报每天更新3次,分别是7:30分,12:00分,18:00分。实时天气情况每30分钟更新1次。

浏览量: 813281

调用量: 4595250204

使用人数: 168780

¥ 0.01 元起

接入点说明: 通过坐标查询对应坐标区域信息,再根据区域查询对应的天气情况。此接口适用于手机端用户。
接口地址: http://route.showapi.com/9-5 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数): 展开收起
参数名称 类型 默认值 示例值 必须 描述
from String
5
输入的坐标类型:
1:标准GPS设备获取的角度坐标,国际标准,WGS84坐标系;
2:GPS获取的米制坐标、sogou地图所用坐标;
3:google地图、高徳、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,也称为火星坐标系GCJ02。
4:3中列表地图坐标对应的米制坐标
5:百度地图采用的经纬度坐标,也称为Bd09坐标系。
6:百度地图采用的米制坐标
7:mapbar地图坐标;
8:51地图坐标
lng String
116.2278
经度值
lat String
40.242266
纬度值
needMoreDay String
0
是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndex String
0
是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourData String 0
0
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不
need3HourForcast String 0
0
是否需要当天每3/6/8小时一次的天气预报列表。1为需要,0为不需要。注意f1是3小时间隔,但f2到f7的间隔可能是6或8小时。
needAlarm String 0
0
是否需要天气预警。1为需要,0为不需要。
...

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
time String
201203061100
预报发布时间
cityInfo CityInfo
查询的地区基本资料
- c1 String
101010100
区域id
- c2 String
beijing
城市英文名
- c3 String
北京
城市中文名
- c4 String
beijing
城市所在市英文名
- c5 String
北京
城市所在市中文名
- c6 String
beijing
城市所在省英文名
- c7 String
北京
城市所在省中文名
- c8 String
china
城市所在国家英文名
- c9 String
中国
城市所在国家中文名
- c10 String
1
城市级别
- c11 String
010
城市区号
- c12 String
100000
邮编
- longitude String
116.391
经度
- latitude String
39.904
纬度
- c15 String
33
海拔
- c16 String
AZ9010
雷达站号
- c17 String
+8
时区
f1 Forecast
今天的天气预报
- day_weather String
多云
白天天气
- night_weather String
暴雨
晚上天气
- day_air_temperature String
26
白天天气温度(摄氏度)
- night_air_temperature String
12
晚上天气温度(摄氏度)
- day_wind_direction String
东北风
白天风向编号
- night_wind_direction String
西北风
晚上风向编号
- day_wind_power String
3-4级10~17m/h
白天风力编号
- night_wind_power String
微风<10m/h
晚上风力编号
- sun_begin_end String
06:44|18:21
日出日落时间(中间用|分割)
- index IndexInfo
指数对象
-- beauty String
化妆指数
-- clothes String
穿衣指数
-- cold String
感冒
-- comfort String
舒适
-- glass String
太阳镜
-- sports String
运动
-- travel String
旅游
-- uv String
紫外线
-- wash_car String
洗车
-- aqi String
大气污染
-- ac String
空调控制
-- ag String
过敏指数
-- cl String
晨练指数
-- dy String
钓鱼指数
-- gj String
逛街指数
-- hc String
划船指数
-- ls String
晾晒指数
-- mf String
美发指数
-- nl String
夜生活指数
-- pj String
啤酒指数
-- pk String
放风筝指数
-- yh String
约会指数
-- zs String
中暑指数
-- xq String
心情指数
- day String
20150627
当前天
- weekday String
6
星期几
- day_weather_pic String
白天天气图标
- night_weather_pic String
晚上天气图标
- day_weather_code String
01
白天的天气编码
- night_weather_code String
02
晚上的天气编码
- air_press String
大气压
- jiangshui String
降水概率
f2 String
今天+1天的天气预报
f3 String
今天+2天的天气预报
f4 String
今天+3天的天气预报
f5 String
今天+4天的天气预报
f6 String
今天+5天的天气预报
f7 String
今天+6天的天气预报
now NowState
现在实时的天气情况
- aqi String
65
空气指数,越小越好
- sd String
56%
空气湿度
- temperature String
26
气温
- temperature_time String
15:00
获得气温的时间
- weather String
天气
- weather_pic String
http://appimg.showapi.com/images/weather/icon/day/02.png
天气小图标
- wind_direction String
南风
风向
- wind_power String
1级
风力
- aqiDetail AqiDetail
aqi明细数据
-- aqi String
38
空气质量指数,越小越好
-- area String
昆明
地区
-- co String
0.713
一氧化碳1小时平均
-- no2 String
12
二氧化氮1小时平均
-- o3 String
104
臭氧1小时平均
-- o3_8h String
52
臭氧8小时平均
-- pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均
-- pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均
-- primary_pollutant String
颗粒物(PM2.5)
首要污染物
-- quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
-- so2 String
13
二氧化硫1小时平均
-- num String
12
排名。越小越好
hourDataList NowState[]
每半小时数据的累积数组。当天0点清空重新累积。
- aqi String
65
空气指数,越小越好
- sd String
56%
空气湿度
- temperature String
26
气温
- temperature_time String
15:00
获得气温的时间
- weather String
天气
- weather_pic String
http://appimg.showapi.com/images/weather/icon/day/02.png
天气小图标
- wind_direction String
南风
风向
- wind_power String
1级
风力
- aqiDetail AqiDetail
aqi明细数据
-- aqi String
38
空气质量指数,越小越好
-- area String
昆明
地区
-- co String
0.713
一氧化碳1小时平均
-- no2 String
12
二氧化氮1小时平均
-- o3 String
104
臭氧1小时平均
-- o3_8h String
52
臭氧8小时平均
-- pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均
-- pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均
-- primary_pollutant String
颗粒物(PM2.5)
首要污染物
-- quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
-- so2 String
13
二氧化硫1小时平均
-- num String
12
排名。越小越好
ret_code String
0
0为成功,其他失败
...

返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"cityInfo": {
			"c1": "101010700",
			"c10": "3",
			"c11": "010",
			"c12": "102200",
			"c15": "80",
			"c16": "AZ9010",
			"c17": "+8",
			"c2": "changping",
			"c3": "昌平",
			"c4": "beijing",
			"c5": "北京",
			"c6": "beijing",
			"c7": "北京",
			"c8": "china",
			"c9": "中国",
			"latitude": 40.206,
			"longitude": 116.165
		},
		"now": {
			"aqi": "71",
			"aqiDetail": {
				"aqi": "71",
				"area": "北京",
				"area_code": "beijing",
				"co": "0.817",
				"no2": "52",
				"o3": "33",
				"o3_8h": "9",
				"pm10": "56",
				"pm2_5": "51",
				"primary_pollutant": "颗粒物(PM2.5)",
				"quality": "良",
				"so2": "3"
			},
			"sd": "70%",
			"temperature": "15",
			"temperature_time": "18:30",
			"weather": "晴",
			"weather_pic": "http://appimg.showapi.com/images/weather/icon/day/00.png",
			"wind_direction": "北风",
			"wind_power": "1级"
		},
		"f1": {
			"air_press": "1008 hPa",
			"day": "20151023",
			"day_air_temperature": "18",
			"day_weather": "晴",
			"day_weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
			"day_wind_direction": "无持续风向",
			"day_wind_power": "微风<10m/h",
			"jiangshui": "3%",
			"night_air_temperature": "9",
			"night_weather": "晴",
			"night_weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
			"night_wind_direction": "无持续风向",
			"night_wind_power": "微风<10m/h",
			"sun_begin_end": "06:35|17:23",
			"weekday": 5,
			"ziwaixian": "中等",
			"index": {
				"beauty": {
					"desc": "请选用中性保湿型霜类化妆品。",
					"title": "保湿"
				},
				"clothes": {
					"desc": "建议穿薄外套或牛仔裤等服装。",
					"title": "较舒适"
				},
				"cold": {
					"desc": "昼夜温差大,易感冒。",
					"title": "易发"
				},
				"comfort": {
					"desc": "白天不冷不热,风力不大。",
					"title": "舒适"
				},
				"glass": {
					"desc": "白天根据户外光线情况佩戴太阳镜",
					"title": "需要"
				},
				"sports": {
					"desc": "户外运动请注意防晒。",
					"title": "较适宜"
				},
				"travel": {
					"desc": "天气较好,丝毫不会影响您出行的心情。",
					"title": "适宜"
				},
				"uv": {
					"desc": "辐射较弱,涂擦SPF12-15、PA+护肤品。",
					"title": "弱"
				},
				"wash_car": {
					"desc": "无雨且风力较小,易保持清洁度。",
					"title": "较适宜"
				}
			},
			"alarmList": [
				{
					"city": "",
					"issueContent": "大风蓝色预警:预计23日23时到24日08时:大连、锦州、营口、盘锦、葫芦岛地区陆地偏北风6级,阵风7级;渤海、渤海海峡、黄海北部偏北风7级,阵风8级。大连、丹东、锦州、营口、盘锦、葫芦岛附近海域和航线将受影响,请注意防范。省气象灾害预警中心10月23日16时35分发布",
					"issueTime": "2015-10-23 16:40:00",
					"province": "辽宁省",
					"signalLevel": "蓝色",
					"signalType": "大风"
				}
			],
			"3hourForcast": [
				{
					"hour": "20时-23时 ",
					"temperature": "12℃/10℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "23时-02时 ",
					"temperature": "10℃/9℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "02时-05时 ",
					"temperature": "10℃/9℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "05时-08时 ",
					"temperature": "13℃/10℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				}
			]
			
		},
		"f1": {
			"air_press": "1008 hPa",
			"day": "20151023",
			"day_air_temperature": "18",
			"day_weather": "晴",
			"day_weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
			"day_wind_direction": "无持续风向",
			"day_wind_power": "微风<10m/h",
			"jiangshui": "3%",
			"night_air_temperature": "9",
			"night_weather": "晴",
			"night_weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
			"night_wind_direction": "无持续风向",
			"night_wind_power": "微风<10m/h",
			"sun_begin_end": "06:35|17:23",
			"weekday": 5,
			"ziwaixian": "中等",
			"index": {
				"beauty": {
					"desc": "请选用中性保湿型霜类化妆品。",
					"title": "保湿"
				},
				"clothes": {
					"desc": "建议穿薄外套或牛仔裤等服装。",
					"title": "较舒适"
				},
				"cold": {
					"desc": "昼夜温差大,易感冒。",
					"title": "易发"
				},
				"comfort": {
					"desc": "白天不冷不热,风力不大。",
					"title": "舒适"
				},
				"glass": {
					"desc": "白天根据户外光线情况佩戴太阳镜",
					"title": "需要"
				},
				"sports": {
					"desc": "户外运动请注意防晒。",
					"title": "较适宜"
				},
				"travel": {
					"desc": "天气较好,丝毫不会影响您出行的心情。",
					"title": "适宜"
				},
				"uv": {
					"desc": "辐射较弱,涂擦SPF12-15、PA+护肤品。",
					"title": "弱"
				},
				"wash_car": {
					"desc": "无雨且风力较小,易保持清洁度。",
					"title": "较适宜"
				}
			},
			"alarmList": [
				{
					"city": "",
					"issueContent": "大风蓝色预警:预计23日23时到24日08时:大连、锦州、营口、盘锦、葫芦岛地区陆地偏北风6级,阵风7级;渤海、渤海海峡、黄海北部偏北风7级,阵风8级。大连、丹东、锦州、营口、盘锦、葫芦岛附近海域和航线将受影响,请注意防范。省气象灾害预警中心10月23日16时35分发布",
					"issueTime": "2015-10-23 16:40:00",
					"province": "辽宁省",
					"signalLevel": "蓝色",
					"signalType": "大风"
				}
			],
			"3hourForcast": [
				{
					"hour": "20时-23时 ",
					"temperature": "12℃/10℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "23时-02时 ",
					"temperature": "10℃/9℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "02时-05时 ",
					"temperature": "10℃/9℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				},
				{
					"hour": "05时-08时 ",
					"temperature": "13℃/10℃",
					"weather": "晴",
					"weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
					"wind_direction": "无持续风向",
					"wind_power": "微风"
				}
			]
			
		},
		"hourDataList": [
			{
				"aqi": "53",
				"aqiDetail": {},
				"sd": "85%",
				"temperature": "9",
				"temperature_time": "00:00",
				"weather": "多云",
				"weather_pic": "http://appimg.showapi.com/images/weather/icon/night/01.png",
				"wind_direction": "北风",
				"wind_power": "1级"
			},
			{
				"aqi": "53",
				"aqiDetail": {},
				"sd": "81%",
				"temperature": "10",
				"temperature_time": "00:30",
				"weather": "多云",
				"weather_pic": "http://appimg.showapi.com/images/weather/icon/night/01.png",
				"wind_direction": "北风",
				"wind_power": "1级"
			} 
		],
		"ret_code": 0,
		"time": "20151023180000"
	}
}