数据来源于国家气象局发布的数据,可根据地区名称、经纬度、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_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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 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 否 是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态,因此实时数组最大长度为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-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_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-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否 要查询的地区idarea String 丽江否 要查询的地区名称。areaid与area两个字段必须输入其中一个。当两者都输入时,系统只取areaidneedMoreDay 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"
}
}
接口地址: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 查到的地区idhourList 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"
}
]
}
}
接口地址: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 0area String 南安areaid String 101230506dayList 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": "北风"
}
]
}
}
接口地址: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 否 地区idarea 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 所查询地区的idlist 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
}
}
接口地址: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否 邮编,比如上海200000phone_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