一、接口介绍
通过坐标区域、IP、地名、景点名称、电话区号或邮编等有效信息可查询天气情况(天气状况、湿度、天气图标、实时温度、风向、风级、紫外线、穿衣指南、空气指数)。可查询到当前天气、未来24小时、7天、15天、40天内天气预报和过往的历史天气情况等数据,广泛应用于能源、电力、农业、生活服务类应用、智能硬件、航天航海、旅游业、建筑业等领域。
二、使用案例截图
三、API文档
当前天气查询
3.1地名-->查询天气
3.1.1接入点说明:
根据地名,获取地名对应的区域ID,再根据区域ID取得天气情况。如果存在多个相同的地名,会选取第一条(数据库中默认的区域ID的排序顺序取第一条)区域信息作为前提条件来查询天气。
3.1.2接口地址:
http[s]://route.showapi.com/92?showapi_appid=替换自己的值&showapi_sign=替换自己的值。
3.1.3更新频率:
实时天气和恶劣天气预警30分钟更新一次,f1f7预报数据一天更新3次,7:30、12:00、18:00更新从当天起往后7天的预报数据。
3.1.4返回格式:
json
3.1.5请求参数
3.1.6返回参数
3.1.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapipublic/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/92\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"areaCode\",\"530700\")
.addTextPara(\"areaid\",\"101291401\")
.addTextPara(\"area\",\"丽江\")
.addTextPara(\"needMoreDay\",\"0\")
.addTextPara(\"needIndex\",\"0\")
.addTextPara(\"need3HourForcast\",\"0\")
.addTextPara(\"needAlarm\",\"0\")
.addTextPara(\"needHourData\",\"\")
.post();
System.out.println(res);
3.2 IP-->查询天气
3.2.1接入点说明:
通过IP地址获取IP对应的区域信息,再根据区域信息获取对应的天气情况。
3.2.2接口地址:
http[s]://route.showapi.com/94?showapi_appid=替换自己的值&showapi_sign=替换自己的值
3.2.3更新频率:
实时天气和恶劣天气预警30分钟更新一次,f1f7预报数据一天更新3次,7:30、12:00、18:00更新从当天起往后7天的预报数据
3.2.4返回格式:
json
3.2.5请求参数
3.2.6返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 时区 |
c0 | String | 110114 | 地区code |
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 | 34级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 | Number | 6 | 星期几 |
day_weather_pic | String | 白天天气图标 | |
night_weather_pic | String | 晚上天气图标 | |
day_weather_code | String | 01 | 白天的天气编码 |
night_weather_code | String | 02 | 晚上的天气编码 |
air_press | String | 大气压 | |
jiangshui | String | 降水概率 | |
ziwaixian | 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 | 排名。越小越好 |
rain | String | 降水量(mm) | |
hourDataList | Object[] | 每半小时数据的累积数组。当天0点清空重新累积。 | |
ret_code | Number | 0 | 0为成功,其他失败 |
3.2.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-4\",\"showapi_appid\",\"showapi_sign\")
.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);
3.3坐标-->查询天气
3.3.1接入点说明:
通过坐标查询对应坐标区域信息,再根据区域查询对应的天气情况。使用场景:手机端通过gps定位查询天气
3.3.2接口地址:
http[s]://route.showapi.com/9-5?showapi_appid=替换自己的值&showapi_sign=替换自己的值
3.3.3返回格式:
json
3.3.4更新频率:
实时天气和恶劣天气预警30分钟更新一次,f1-f7预报数据一天更新3次,7:30、12:00、18:00更新从当天起往后7天的预报数据
3.3.6请求参数
参数名称 | 类型 | 示例值 | 必须 | 描述 |
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为不需要。 |
3.3.7返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 时区 |
- c0 | String | 110000 | 地区code |
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 | Number | 6 | 星期几 |
- day_weather_pic | String | 白天天气图标 | |
- night_weather_pic | String | 晚上天气图标 | |
- day_weather_code | String | 01 | 白天的天气编码 |
- night_weather_code | String | 02 | 晚上的天气编码 |
- air_press | String | 大气压 | |
- jiangshui | String | 降水概率 | |
- 3hourForcast | Object[] | 3小时预报 | |
- 0 | Object | ||
- precip | String | 0.0 | 降水(mm) |
- wind_direction | String | 西风 | 风向 |
- wind_power | String | <3级 | 风力 |
- temperature_max | String | 14 | |
- weather | String | 晴 | |
- weather_pic | String | http://app1.showapi.com/weather/icon/day/00.png | |
- hour | String | 8时-11时 | |
- temperature_min | String | 6 | |
- temperature | String | 6 | |
- ziwaixian | 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 | 排名。越小越好 |
- rain | String | 0.1 | 降水量(mm) |
hourDataList | Object[] | 每半小时数据的累积数组。当天0点清空重新累积。 | |
ret_code | Number | 0 | 0为成功,其他失败 |
3.3.8请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-5\",\"showapi_appid\",\"showapi_sign\")
.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);
3.4区号邮编-->查询天气
3.4.1接入点说明:
使用电话区号或邮编查询天气
3.4.2接口地址:
http[s]://route.showapi.com/9-10?showapi_appid=替换自己的值&showapi_sign=替换自己的值
3.4.3返回格式:
json
3.4.4更新频率:
实时天气和恶劣天气预警30分钟更新一次,f1-f7预报数据一天更新3次,7:30、12:00、18:00更新从当天起往后7天的预报数据
3.5.6请求参数
参数名称 | 类型 | 示例值 | 必须 | 描述 |
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为不需要。 |
3.6.7返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 时区 |
- c0 | String | 110114 | 地区code |
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 | Number | 6 | 星期几 |
- day_weather_pic | String | 白天天气图标 | |
- night_weather_pic | String | 晚上天气图标 | |
- day_weather_code | String | 01 | 白天的天气编码 |
- night_weather_code | String | 02 | 晚上的天气编码 |
- air_press | String | 大气压 | |
- jiangshui | String | 降水概率 | |
- ziwaixian | 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 | 排名。越小越好 |
- rain | String | 降水量(mm) | |
hourDataList | String | 每半小时数据的累积数组。当天0点清空重新累积。 | |
ret_code | Number | 0 | 0为成功,其他失败 |
3.7.8请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-6\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"spotId\",\"\")
.addTextPara(\"area\",\"泰山\")
.addTextPara(\"needMoreDay\",\"0\")
.addTextPara(\"needIndex\",\"0\")
.addTextPara(\"needHourData\",\"0\")
.addTextPara(\"need3HourForcast\",\"0\")
.addTextPara(\"needAlarm\",\"0\")
.post();
System.out.println(res);
3.5景点名称-->查询天气
3.5.1接入点说明:
根据景点ID、景点名称来获取景点的天气情况。全国景点的id从这个接口获取[全国景点查询接口]
3.5.2接口地址:
http[s]://route.showapi.com/9-6?showapi_appid=替换自己的值&showapi_sign=替换自己的值
3.5.3返回格式:
json
3.5.4更新频率:
实时天气和恶劣天气预警30分钟更新一次,f1-f7预报数据一天更新3次,7:30、12:00、18:00更新从当天起往后7天的预报数据
3.5.5返回格式:
json
3.5.6请求参数
参数名称 | 类型 | 示例值 | 必须 | 描述 |
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为不需要。 |
3.5.7返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 时区 |
- c0 | String | 110114 | 地区code |
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 | Number | 6 | 星期几 |
- day_weather_pic | String | 白天天气图标 | |
- night_weather_pic | String | 晚上天气图标 | |
- day_weather_code | String | 01 | 白天的天气编码 |
- night_weather_code | String | 02 | 晚上的天气编码 |
- air_press | String | 大气压 | |
- jiangshui | String | 降水概率 | |
- ziwaixian | 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 | 排名。越小越好 |
- rain | String | 降水量(mm) | |
hourDataList | String | 每半小时数据的累积数组。当天0点清空重新累积。 | |
ret_code | Number | 0 | 0为成功,其他失败 |
3.5.8请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-6\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"spotId\",\"\")
.addTextPara(\"area\",\"泰山\")
.addTextPara(\"needMoreDay\",\"0\")
.addTextPara(\"needIndex\",\"0\")
.addTextPara(\"needHourData\",\"0\")
.addTextPara(\"need3HourForcast\",\"0\")
.addTextPara(\"needAlarm\",\"0\")
.post();
System.out.println(res)
四、未来天气查询
4.1 id或名称-->查询24小时预报
4.1.1接入点说明:
根据区域ID和区域名,获取24小时的天气预报。区域名可能存在重名的情况,建议尽量使用区域ID来获取数据。需要说明的是24小时天气数据是每半小时更新一次
4.1.2接口地址:
http[s]://route.showapi.com/9-8?showapi_appid=替换自己的值&showapi_sign=替换自己的值
4.1.3返回格式:
Json
4.1.4更新频率:
每天更新3次,7:30,12:00, 18:00更新24小时预报
4.1.5请求参数
参数名称 | 类型 | 示例值 | 必须 | 描述 |
areaCode | String | 530700 | 否 | 地区code. 此参数和areaid和area必须输入一个 |
areaid | String | 101291401 | 否 | 地区id. 此参数和areaCode和area必须输入一个(以后可能会废弃,请以areaCode为准) |
area | String | 丽江 | 否 | 地区名称 |
4.1.6返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 气温 |
areaCode | String | 310000 | 查到的地区code |
4.1.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-8\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"areaCode\",\"530700\")
.addTextPara(\"areaid\",\"101291401\")
.addTextPara(\"area\",\"丽江\")
.post();
System.out.println(res);
4.1.8返回示例
{
\"showapi_res_code\": 0,
\"showapi_res_error\": \"\",
\"showapi_res_id\":\"ce135f6739294c63be0c021b76b6fbff\",
\"showapi_res_body\": {
\"ret_code\": 0,
\"area\": \"上海\",
\"areaid\": \"101020100\",
\"areaCode\":\"310000\",
\"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\"
}
]
}
}
4.2 id或名称-->查未来15天预报
4.2.1接入点说明:
根据区域ID和区域名,获取当前日期至未来15天内的天气预报。因区域名可能存在重名的情况,建议尽量使用区域ID来获取数据。需要说明的是未来15天的天气数据是每天7点、12点、18点各更新一次
4.2.2接口地址:
http[s]://route.showapi.com/9-9?showapi_appid=替换自己的值&showapi_sign=替换自己的值
4.2.3返回格式:
Json
4.2.4更新频率:
每天更新3次,9:00,12:00, 19:00更新从当天起往后15天的预报数据
4.2.5请求参数
参数名称 | 类型 | 示例值 | 必须 | 描述 |
areaCode | String | 530700 | 否 | 地区code. 此参数和areaid和area必须输入一个。 |
areaid | String | 101291401 | 否 | 地区id. 此参数和areaCode和area必须输入一个。(以后可能会废弃,以areaCode为准) |
area | String | 丽江 | 否 | 地区名称 |
4.2.6返回参数
参数名称 | 类型 | 示例值 | 描述 |
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 | 北风 | 夜晚风力 |
areaCode | String | 350500 |
4.2.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-9\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"areaCode\",\"530700\")
.addTextPara(\"areaid\",\"101291401\")
.addTextPara(\"area\",\"丽江\")
.post();
System.out.println(res);
4.2.8返回示例
{
\"showapi_res_code\": 0,
\"showapi_res_error\": \"\",
\"showapi_res_id\":\"ce135f6739294c63be0c021b76b6fbff\",
\"showapi_res_body\": {
\"ret_code\": 0,
\"area\": \"南安\",
\"areaid\": \"101230506\",
\"areaCode\":\"350500\",
\"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\": \"北风\"
}
]
}
}
4.3 id或名称-->查未来15天预报
4.3.1接入点说明:
根据区域ID和区域名,获取当前日期至未来40天内的天气预报。因区域名可能存在重名的情况,建议尽量使用区域ID来获取数据。需要说明的是未来15天的天气数据是每天7点、12点、18点各更新一次。
4.3.2接口地址:
http[s]://route.showapi.com/9-12?showapi_appid=替换自己的值&showapi_sign=替换自己的值
4.3.3返回格式:
json
4.3.4更新频率:
每天更新3次,9:00,12:00, 19:00更新从当天起往后40天的预报数据
4.3.5请求参数:
参数名称 | 类型 | 示例值 | 必须 | 描述 |
areaCode | String | 530700 | 否 | 地区code. 此参数和areaid和area必须输入一个 |
areaid | String | 101291401 | 否 | 地区id. 此参数和areaCode和area必须输入一个(以后可能会废弃,以areaCode为准) |
area | String | 丽江 | 否 | 地区名称 |
4.3.6返回参数:
参数名称 | 类型 | 示例值 | 描述 |
ret_code | Number | 0 | |
area | String | 南安 | |
areaid | String | 101230506 | |
day40List | 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 | 北风 | 夜晚风力 |
areaCode | String | 350500 |
4.3.7请求代码示例:
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-12\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"areaCode\",\"530700\")
.addTextPara(\"areaid\",\"101291401\")
.addTextPara(\"area\",\"丽江\")
.post();
System.out.println(res);
4.3.8返回示例:
{
\"showapi_res_code\": 0,
\"showapi_res_error\": \"\",
\"showapi_res_id\":\"ce135f6739294c63be0c021b76b6fbff\",
\"showapi_res_body\": {
\"ret_code\": 0,
\"area\": \"南安\",
\"areaid\": \"101230506\",
\"areaCode\":\"350500\",
\"day40List\": [
{
\"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\": \"北风\"
}
]
}
}
五、历史天气查询
5.1 id或名称-->查询历史天气
5.1.1接入点说明:
根据地区id或名称查询历史天气。每次返回一个地区1个月的数据。历史数据从2011年开始。
5.1.2接口地址:
http[s]://route.showapi.com/9-7?showapi_appid=替换自己的值&showapi_sign=替换自己的值
5.1.3返回格式:
json
5.1.4更新频率:
每天早上4:00更新昨天历史天气
5.1.5请求参数:
参数名称 | 类型 | 示例值 | 必须 | 描述 |
areaCode | String | 110000 | 否 | 地区code |
areaid | String | 101010100 | 否 | 地区id |
month | String | 201601 | 否 | 查询的月份,格式yyyyMM。最早的数据是2011年1月。 |
startDate | String | 20160504 | 否 | 查询的开始日期,格式yyyyMMdd。最早的数据是2011年1月1日。 |
endDate | String | 20160510 | 否 | 查询的结束日期,格式yyyyMMdd。最早的数据是2011年1月1日。 |
area | String | 北京 | 否 | 地区名称。id和code和名称必须输入其中1个。如果都输入,以code为准 |
5.1.5返回参数:
参数名称 | 类型 | 示例值 | 描述 |
area | String | 北京 | 所查询地区名称 |
areaid | String | 101010100 | 所查询地区的id(以后可能会废弃,已areaCode为准) |
list | Object[] | 所查月分每日的天气历史记录。 | |
- 0 | Object | ||
- max_temperature | String | 2℃ | 最高温度 |
- min_temperature | String | -7℃ | 最低温度 |
- time | String | 20160113 | 时间 |
- weather | String | 晴-多云 | 天气 |
- wind_direction | String | 无持续风向 | 风向 |
- wind_power | String | 微风 | 风力 |
- aqiLevel | String | 空气质量等级 | |
- aqi | String | 空气质量指数(若无指数返回-1) | |
- aqiInfo | String | 空气质量指数类别 | |
month | String | 201601 | 所查询月份 |
ret_code | Number | 0 | 0为成功,其他失败 |
areaCode | String | 110000 | 所查地区code |
startDate | String | 开始日期(输入参数month有值的情况下,以month为准) | |
endDate | String | 结束日期(输入参数month有值的情况下,以month为准) |
5.1.6请求示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-7\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"areaCode\",\"110000\")
.addTextPara(\"areaid\",\"101010100\")
.addTextPara(\"month\",\"201601\")
.addTextPara(\"startDate\",\"20160504\")
.addTextPara(\"endDate\",\"20160510\")
.addTextPara(\"area\",\"北京\")
.post();
System.out.println(res);
5.1.6返回示例
{
\"showapi_res_error\": \"\",
\"showapi_res_code\": 0,
\"showapi_res_id\": \"5f619fef8d57bae110c4628d\",
\"showapi_res_body\": {
\"startDate\": \"20160504\",
\"ret_code\": 0,
\"area\": \"北京\",
\"areaCode\": \"110000\",
\"month\": \"201601\",
\"showapi_fee_code\": 0,
\"areaid\": \"101010100\",
\"endDate\": \"20160510\",
\"list\": [
{
\"aqiLevel\": \"6\",
\"time\": \"20160101\",
\"min_temperature\": \"-4℃\",
\"wind_direction\": \"无持续风向\",
\"wind_power\": \"微风\",
\"aqi\": \"311\",
\"weather\": \"霾\",
\"max_temperature\": \"5℃\",
\"aqiInfo\": \"严重污染\"
},
{
\"aqiLevel\": \"6\",
\"time\": \"20160102\",
\"min_temperature\": \"-4℃\",
\"wind_direction\": \"无持续风向\",
\"wind_power\": \"微风\",
\"aqi\": \"415\",
\"weather\": \"霾-雾\",
\"max_temperature\": \"6℃\",
\"aqiInfo\": \"严重污染\"
},
{
\"aqiLevel\": \"5\",
\"time\": \"20160103\",
\"min_temperature\": \"-4℃\",
\"wind_direction\": \"无持续风向~北风\",
\"wind_power\": \"微风~3-4级\",
\"aqi\": \"285\",
\"weather\": \"霾-多云\",
\"max_temperature\": \"3℃\",
\"aqiInfo\": \"重度污染\"
},
{
\"aqiLevel\": \"1\",
\"time\": \"20160104\",
\"min_temperature\": \"-6℃\",
\"wind_direction\": \"北风~无持续风向\",
\"wind_power\": \"3-4级~微风\",
\"aqi\": \"22\",
\"weather\": \"多云-晴\",
\"max_temperature\": \"2℃\",
\"aqiInfo\": \"优\"
}
]
}
}
六、工具
6.1 地名-->查询对应的地名id
6.1.1接入点说明:
地名会存在重名的情况,为了避免这一情况的发生,在此提供了地名和区域ID的对应关系,然后根据区域ID来查询24小时天气、未来15天预报、历史天气等数据。
6.1.2接口地址:
http[s]://route.showapi.com/9-3?showapi_appid=替换自己的值&showapi_sign=替换自己的值
6.1.3返回格式:
json
6.1.4请求参数:
6.1.5返回参数:
参数名称 | 类型 | 示例值 | 描述 |
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.22 | 经度 |
- c11 | String | 0888 | 城市区号 |
- c10 | String | 2 | 城市级别 |
- latitude | Number | 26.9 | 纬度 |
- c12 | String | 674100 | 邮编 |
- c15 | String | 2394 | 海拔 |
- distric | String | 丽江 | 地区 |
- areaid | String | 101291401 | 地名id |
- areaCode | String | 530700 | 地区code |
6.1.6请求示例
以下是JAVA代码示例:
//更多说明请访问仓库地址:https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign,你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest(\"http://route.showapi.com/9-3\",\"showapi_appid\",\"showapi_sign\")
.addTextPara(\"area\",\"丽江\")
.post();
System.out.println(res);
6.1.7返回示例
{
\"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\",
\"areaCode\":\"530700\"
}
]
}
}
七、天气对饮应的图标序号
点此打包下载天气对应图标
点此下载支持的所有城市列表
官网查看帮助手册