天气预报

第三方服务商
价格:¥0.01元起  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

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

坐标-->查询天气


接口地址: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_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起 

参数名称类型默认值示例值必须描述
fromString 5输入的坐标类型:
1:标准GPS设备获取的角度坐标,国际标准,WGS84坐标系;
2:GPS获取的米制坐标、sogou地图所用坐标;
3:google地图、高徳、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,也称为火星坐标系GCJ02。
4:3中列表地图坐标对应的米制坐标
5:百度地图采用的经纬度坐标,也称为Bd09坐标系。
6:百度地图采用的米制坐标
7:mapbar地图坐标;
8:51地图坐标
lngString 116.2278经度值
latString 40.242266纬度值
needMoreDayString 0是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndexString 0是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourDataString 0是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不
need3HourForcastString 0是否需要当天每3/6/8小时一次的天气预报列表。1为需要,0为不需要。注意f1是3小时间隔,但f2到f7的间隔可能是6或8小时。
needAlarmString 0是否需要天气预警。1为需要,0为不需要。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-5","my_appId","my_appSecret") .addTextPara("from","5") .addTextPara("lng","116.2278") .addTextPara("lat","40.242266") .addTextPara("needMoreDay","0") .addTextPara("needIndex","0") .addTextPara("needHourData","0") .addTextPara("need3HourForcast","0") .addTextPara("needAlarm","0") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
time String201203061100预报发布时间
cityInfo Object[] 查询的地区基本资料
-  c1 String101010100区域id
-  c2 Stringbeijing城市英文名
-  c3 String北京城市中文名
-  c4 Stringbeijing城市所在市英文名
-  c5 String北京城市所在市中文名
-  c6 Stringbeijing城市所在省英文名
-  c7 String北京城市所在省中文名
-  c8 Stringchina城市所在国家英文名
-  c9 String中国城市所在国家中文名
-  c10 String1城市级别
-  c11 String010城市区号
-  c12 String100000邮编
-  longitude String116.391经度
-  latitude String39.904纬度
-  c15 String33海拔
-  c16 StringAZ9010雷达站号
-  c17 String+8时区
f1 Object[] 今天的天气预报
-  day_weather String多云白天天气
-  night_weather String暴雨晚上天气
-  day_air_temperature String26白天天气温度(摄氏度)
-  night_air_temperature String12晚上天气温度(摄氏度)
-  day_wind_direction String东北风白天风向编号
-  night_wind_direction String西北风晚上风向编号
-  day_wind_power String3-4级10~17m/h白天风力编号
-  night_wind_power String微风<10m/h晚上风力编号
-  sun_begin_end String06:44|18:21日出日落时间(中间用|分割)
-  index Object[] 指数对象
-  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 String20150627当前天
-  weekday String6星期几
-  day_weather_pic String 白天天气图标
 
-  night_weather_pic String 晚上天气图标
-  day_weather_code String01白天的天气编码
-  night_weather_code String02晚上的天气编码
-  air_press String 大气压
-  jiangshui String 降水概率
f2 String 今天+1天的天气预报
f3 String 今天+2天的天气预报
f4 String 今天+3天的天气预报
f5 String 今天+4天的天气预报
f6 String 今天+5天的天气预报
f7 String 今天+6天的天气预报
now Object[] 现在实时的天气情况
-  aqi String65空气指数,越小越好
-  sd String56%空气湿度
-  temperature String26气温
-  temperature_time String15:00获得气温的时间
-  weather String天气
-  weather_pic Stringhttp://appimg.showapi.com/images/weather/icon/day/02.png天气小图标
-  wind_direction String南风风向
-  wind_power String1级风力
-  aqiDetail Object[] aqi明细数据
-  aqi String38空气质量指数,越小越好
-  area String昆明地区
-  co String0.713一氧化碳1小时平均,mg/m3
-  no2 String12二氧化氮1小时平均,μg/m3
-  o3 String104臭氧1小时平均,μg/m3
-  o3_8h String52臭氧8小时平均,μg/m3
-  pm10 String37颗粒物(粒径小于等于10μm)1小时平均,μg/m3
-  pm2_5 String19颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
-  primary_pollutant String颗粒物(PM2.5)首要污染物
-  quality String空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
-  so2 String13二氧化硫1小时平均,μg/m3
-  num String12排名。越小越好
hourDataList Object[] 每半小时数据的累积数组。当天0点清空重新累积。
ret_code String00为成功,其他失败
...
返回示例:{ "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" } }

IP-->查询天气


接口地址:http://route.showapi.com/9-4 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
ip String
113.78.19.201
要查询天气的ip地址,如果不写,则系统取客户端的ip地址。
needMoreDay String
0
是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndex String
0
是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourData String
0
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不
need3HourForcast String
0
是否需要当天每3/6/8小时一次的天气预报列表。1为需要,0为不需要。注意f1是3小时间隔,但f2到f7的间隔可能是6或8小时。
needAlarm String
0
是否需要天气预警。1为需要,0为不需要。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-4","my_appId","my_appSecret") .addTextPara("ip","113.78.19.201") .addTextPara("needMoreDay","0") .addTextPara("needIndex","0") .addTextPara("needHourData","0") .addTextPara("need3HourForcast","0") .addTextPara("needAlarm","0") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
time String
201203061100
预报发布时间
cityInfo Object[]
查询的地区基本资料
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 Object[]
今天的天气预报
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 Object[]
指数对象
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 Object[]
现在实时的天气情况
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 Object[]
aqi明细数据
aqi String
38
空气质量指数,越小越好
area String
昆明
地区
co String
0.713
一氧化碳1小时平均,mg/m3
no2 String
12
二氧化氮1小时平均,μg/m3
o3 String
104
臭氧1小时平均,μg/m3
o3_8h String
52
臭氧8小时平均,μg/m3
pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均,μg/m3
pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
primary_pollutant String
颗粒物(PM2.5)
首要污染物
quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
so2 String
13
二氧化硫1小时平均,μg/m3
num String
12
排名。越小越好
hourDataList Object[]
每半小时数据的累积数组。当天0点清空重新累积。
ret_code String
0
0为成功,其他失败
...
返回示例:{ "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" } }

地名-->查询天气


接口地址:http://route.showapi.com/9-2 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
areaid String
101291401
要查询的地区id
area String
丽江
要查询的地区名称。areaid与area两个字段必须输入其中一个。当两者都输入时,系统只取areaid
needMoreDay String
0
是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndex String
0
是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourData String
0
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不
need3HourForcast String
0
是否需要当天每3/6/8小时一次的天气预报列表。1为需要,0为不需要。注意f1是3小时间隔,但f2到f7的间隔可能是6或8小时。
needAlarm String
0
是否需要天气预警。1为需要,0为不需要。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-2","my_appId","my_appSecret") .addTextPara("areaid","101291401") .addTextPara("area","丽江") .addTextPara("needMoreDay","0") .addTextPara("needIndex","0") .addTextPara("needHourData","0") .addTextPara("need3HourForcast","0") .addTextPara("needAlarm","0") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
time String
201203061100
预报发布时间
cityInfo Object[]
查询的地区基本资料
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 Object[]
今天的天气预报
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 Object[]
指数对象
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 Object[]
现在实时的天气情况
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 Object[]
aqi明细数据
aqi String
38
空气质量指数,越小越好
area String
昆明
地区
co String
0.713
一氧化碳1小时平均,mg/m3
no2 String
12
二氧化氮1小时平均,μg/m3
o3 String
104
臭氧1小时平均,μg/m3
o3_8h String
52
臭氧8小时平均,μg/m3
pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均,μg/m3
pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
primary_pollutant String
颗粒物(PM2.5)
首要污染物
quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
so2 String
13
二氧化硫1小时平均,μg/m3
num String
12
排名。越小越好
hourDataList Object[]
每半小时数据的累积数组。当天0点清空重新累积。
ret_code String
0
0为成功,其他失败
...
返回示例:{ "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" } }

id或名称->查询24小时预报


接口地址:http://route.showapi.com/9-8 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
areaid String
101291401
地区id. 此参数和area必须二选一输入一个。
area String
丽江
地区名称
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-8","my_appId","my_appSecret") .addTextPara("areaid","101291401") .addTextPara("area","丽江") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code Number
0
0为成功,其他失败
area String
上海
查到的地区名
areaid String
101020100
查到的地区id
hourList Object[]
24小时预报列表
0 Object
weather_code String
01
天气代号
time String
201611061000
时间
wind_direction String
东风
风向
wind_power String
4-5级 8.0~10.7m/s
风力
weather String
多云
天气
temperature String
21
气温
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": 0, "area": "上海", "areaid": "101020100", "hourList": [ { "weather_code": "01", "time": "201611061000", "wind_direction": "东风", "wind_power": "4-5级 8.0~10.7m/s", "weather": "多云", "temperature": "21" }, { "weather_code": "01", "time": "201611060900", "wind_direction": "东风", "wind_power": "3-4级 5.5~7.9m/s", "weather": "多云", "temperature": "19" } ] } }

id或名称->查未来15天预报


接口地址:http://route.showapi.com/9-9 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
areaid String
101291401
地区id. 此参数和area必须二选一输入一个。
area String
丽江
地区名称
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-9","my_appId","my_appSecret") .addTextPara("areaid","101291401") .addTextPara("area","丽江") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code Number
0
area String
南安
areaid String
101230506
dayList Object[]
0 Object
night_weather_code String
01
夜晚天气代号
day_weather String
多云
白天天气
night_weather String
多云
夜晚天气
night_wind_power String
微风
夜晚风力
day_wind_power String
微风
白天风力
day_weather_code String
01
白天天气代号
daytime String
20161106
日期
day_weather_pic String
http://appimg.showapi.com/images/weather/icon/day/01.png
白天天气图片
night_air_temperature String
21
夜晚气温
day_air_temperature String
27
白天气温
day_wind_direction String
无持续风向
白天风力
night_weather_pic String
http://appimg.showapi.com/images/weather/icon/night/01.png
夜晚天气图片
night_wind_direction String
北风
夜晚风力
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": 0, "area": "南安", "areaid": "101230506", "dayList": [ { "night_weather_code": "01", "day_weather": "多云", "night_weather": "多云", "night_wind_power": "微风", "day_wind_power": "微风", "day_weather_code": "01", "daytime": "20161106", "day_weather_pic": "http://appimg.showapi.com/images/weather/icon/day/01.png", "night_air_temperature": "21", "day_air_temperature": "27", "day_wind_direction": "无持续风向", "night_weather_pic": "http://appimg.showapi.com/images/weather/icon/night/01.png", "night_wind_direction": "北风" }, { "night_weather_code": "01", "day_weather": "晴", "night_weather": "多云", "night_wind_power": "3-4级", "day_wind_power": "微风", "day_weather_code": "00", "daytime": "20161107", "day_weather_pic": "http://appimg.showapi.com/images/weather/icon/day/00.png", "night_air_temperature": "21", "day_air_temperature": "27", "day_wind_direction": "无持续风向", "night_weather_pic": "http://appimg.showapi.com/images/weather/icon/night/00.png", "night_wind_direction": "北风" } ] } }

id或名称-->查询历史天气


接口地址:http://route.showapi.com/9-7 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
areaid String
地区id
area String
北京
地区名称。id和名称必须输入其中1个。如果都输入,以id为准
month String
201601
查询的月份,格式yyyyMM。最早的数据是2011年1月。
startDate String
20160504
查询的开始日期,格式yyyyMMdd。最早的数据是2011年1月1日。
endDate String
20160510
查询的结束日期,格式yyyyMMdd。最早的数据是2011年1月1日。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-7","my_appId","my_appSecret") .addTextPara("areaid","") .addTextPara("area","北京") .addTextPara("month","201601") .addTextPara("startDate","20160504") .addTextPara("endDate","20160510") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
area String
北京
所查询地区名称
areaid String
101010100
所查询地区的id
list Object[]
所查月分每日的天气历史记录。
0 Object
max_temperature String
2℃
最高温度
min_temperature String
-7℃
最低温度
time String
20160113
时间
weather String
晴-多云
天气
wind_direction String
无持续风向
风向
wind_power String
微风
风力
month String
201601
所查询月份
ret_code Number
0
0为成功,其他失败
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "area": "北京", "areaid": "101010100", "list": [ { "max_temperature": "2℃", "min_temperature": "-7℃", "time": "20160113", "weather": "晴-多云", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "0℃", "min_temperature": "-8℃", "time": "20160112", "weather": "晴", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "-1℃", "min_temperature": "-9℃", "time": "20160111", "weather": "晴", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "1℃", "min_temperature": "-8℃", "time": "20160110", "weather": "多云-晴", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "3℃", "min_temperature": "-6℃", "time": "20160109", "weather": "晴-多云", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "2℃", "min_temperature": "-8℃", "time": "20160108", "weather": "晴", "wind_direction": "北风~无持续风向", "wind_power": "3-4级~微风" }, { "max_temperature": "2℃", "min_temperature": "-7℃", "time": "20160107", "weather": "晴", "wind_direction": "北风~无持续风向", "wind_power": "3-4级~微风" }, { "max_temperature": "3℃", "min_temperature": "-6℃", "time": "20160106", "weather": "晴", "wind_direction": "北风", "wind_power": "3-4级" }, { "max_temperature": "1℃", "min_temperature": "-7℃", "time": "20160105", "weather": "晴", "wind_direction": "北风~无持续风向", "wind_power": "3-4级~微风" }, { "max_temperature": "2℃", "min_temperature": "-6℃", "time": "20160104", "weather": "多云-晴", "wind_direction": "北风~无持续风向", "wind_power": "3-4级~微风" }, { "max_temperature": "3℃", "min_temperature": "-4℃", "time": "20160103", "weather": "霾-多云", "wind_direction": "无持续风向~北风", "wind_power": "微风~3-4级" }, { "max_temperature": "6℃", "min_temperature": "-4℃", "time": "20160102", "weather": "霾-雾", "wind_direction": "无持续风向", "wind_power": "微风" }, { "max_temperature": "5℃", "min_temperature": "-4℃", "time": "20160101", "weather": "霾", "wind_direction": "无持续风向", "wind_power": "微风" } ], "month": "201601", "ret_code": 0 } }

地名-->查询对应的地名id


接口地址:http://route.showapi.com/9-3 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
area String
丽江
地区名称,如丽江
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-3","my_appId","my_appSecret") .addTextPara("area","丽江") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code Number
0
0为成功,其他失败
list Object[]
根据地名模糊匹配出来的城市列表。
0 Object
prov String
云南
城市所在省
area String
丽江
地名
cityInfo Object
城市信息
c6 String
yunnan
城市所在省英文名
c5 String
丽江
城市所在市中文名
c4 String
lijiang
城市所在市英文名
c3 String
丽江
城市中文名
c9 String
中国
城市所在国家中文名
c8 String
china
城市所在国家英文名
c7 String
云南
城市所在省中文名
c17 String
+8
时区
c16 String
AZ9888
雷达站号
c1 String
101291401
区域id
c2 String
lijiang
城市英文名
longitude Number
100
经度
c11 String
0888
城市区号
c10 String
2
城市级别
latitude Number
27
纬度
c12 String
674100
邮编
c15 String
2394
海拔
distric String
丽江
地区
areaid String
101291401
地名id
...
返回示例:{ "showapi_res_error": "", "showapi_res_code": 0, "showapi_res_id": "3caf6167505d4cbc9443934efb884d7b", "showapi_res_body": { "ret_code": 0, "showapi_fee_code": 0, "list": [ { "prov": "云南", "area": "丽江", "cityInfo": { "c6": "yunnan", "c5": "丽江", "c4": "lijiang", "c3": "丽江", "c9": "中国", "c8": "china", "c7": "云南", "c17": "+8", "c16": "AZ9888", "c1": "101291401", "c2": "lijiang", "longitude": 100.222, "c11": "0888", "c10": "2", "latitude": 26.903, "c12": "674100", "c15": "2394" }, "distric": "丽江", "areaid": "101291401" } ] } }

区号邮编-->查询天气


接口地址:http://route.showapi.com/9-10 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
post_code String
200000
邮编,比如上海200000
phone_code String
021
电话区号,比如上海021。 注意邮编和区号必须二选一输入。都输入时,以邮编为准。
needMoreDay String
0
是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndex String
0
是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourData String
0
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0. 1为需要 0为不
need3HourForcast String
0
是否需要当天每3/6小时一次的天气预报列表。1为需要,0为不需要。
needAlarm String
0
是否需要天气预警。1为需要,0为不需要。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-10","my_appId","my_appSecret") .addTextPara("post_code","200000") .addTextPara("phone_code","021") .addTextPara("needMoreDay","0") .addTextPara("needIndex","0") .addTextPara("needHourData","0") .addTextPara("need3HourForcast","0") .addTextPara("needAlarm","0") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
time String
预报发布时间
cityInfo Object[]
查询的地区基本资料
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 Object[]
今天的天气预报
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 Object[]
指数对象
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 Object[]
现在实时的天气情况
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 Object[]
aqi明细数据
aqi String
38
空气质量指数,越小越好
area String
昆明
地区
co String
0.713
一氧化碳1小时平均,mg/m3
no2 String
12
二氧化氮1小时平均,μg/m3
o3 String
104
臭氧1小时平均,μg/m3
o3_8h String
52
臭氧8小时平均,μg/m3
pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均,μg/m3
pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
primary_pollutant String
颗粒物(PM2.5)
首要污染物
quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
so2 String
13
二氧化硫1小时平均,μg/m3
num String
12
排名。越小越好
hourDataList String
每半小时数据的累积数组。当天0点清空重新累积。
ret_code String
0
0为成功,其他失败
...
返回示例:{ "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" } }

景点名称-->查询天气


接口地址:http://route.showapi.com/9-6 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
spotId String
景点id。id取值为本平台中的 [全国景点查询接口]
area String
泰山
景点名称
needMoreDay String
0
是否需要返回7天数据中的后4天。1为返回,0为不返回。
needIndex String
0
是否需要返回指数数据,比如穿衣指数、紫外线指数等。1为返回,0为不返回。
needHourData String
0
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为48。每天0点长度初始化为0. 1为需要 0为不
need3HourForcast String
0
是否需要当天每3/6/8小时一次的天气预报列表。1为需要,0为不需要。注意f1是3小时间隔,但f2到f7的间隔可能是6或8小时。
needAlarm String
0
是否需要天气预警。1为需要,0为不需要。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/9-6","my_appId","my_appSecret") .addTextPara("spotId","") .addTextPara("area","泰山") .addTextPara("needMoreDay","0") .addTextPara("needIndex","0") .addTextPara("needHourData","0") .addTextPara("need3HourForcast","0") .addTextPara("needAlarm","0") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
time String
预报发布时间
cityInfo Object[]
查询的地区基本资料
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 Object[]
今天的天气预报
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 Object[]
指数对象
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 Object[]
现在实时的天气情况
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 Object[]
aqi明细数据
aqi String
38
空气质量指数,越小越好
area String
昆明
地区
co String
0.713
一氧化碳1小时平均,mg/m3
no2 String
12
二氧化氮1小时平均,μg/m3
o3 String
104
臭氧1小时平均,μg/m3
o3_8h String
52
臭氧8小时平均,μg/m3
pm10 String
37
颗粒物(粒径小于等于10μm)1小时平均,μg/m3
pm2_5 String
19
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
primary_pollutant String
颗粒物(PM2.5)
首要污染物
quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
so2 String
13
二氧化硫1小时平均,μg/m3
num String
12
排名。越小越好
hourDataList String
每半小时数据的累积数组。当天0点清空重新累积。
ret_code String
0
0为成功,其他失败
...
返回示例:{ "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" } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐