天气预报数据接口「天气接口api解析」

小编在此向大家介绍拥有105亿 调用量的产品，该接口文档清晰，对接方便，还有服务很好。

公司成立于2015年，是API行业的早期开拓者，也是最早一批入驻阿里、百度、腾讯、华为、京东数据市场的服务商，多次荣获阿里“最佳服务商”称号并在阿里官网首页进行推荐展示。2017年，公司受邀参与云栖大会演讲，并荣获“最佳创新奖”。

一、接口介绍

通过坐标区域、IP、地名、景点名称、电话区号或邮编等有效信息可查询天气情况（天气状况、湿度、天气图标、实时温度、风向、风级、紫外线、穿衣指南、空气指数）。可查询到当前天气、未来24小时、7天、15天、40天内天气预报和过往的历史天气情况等数据，广泛应用于能源、电力、农业、生活服务类应用、智能硬件、航天航海、旅游业、建筑业等领域。

二、使用案例截图

店铺浏览地址如下：

阿里云店铺：https://shop3a017cy7.market.aliyun.com/?spm=5176.730005

华为云店铺：https://marketplace.huaweicloud.com/contents/8347c0f7-ffc3-4578-a413-7e470a8720a1

官网地址：https://www.showapi.com/apiGateway/view/9

三、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 地名-->查询对应的地名id6.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"

}

]

}

}

七、天气对饮应的图标序号

点此打包下载天气对应图标

点此下载支持的所有城市列表

官网查看帮助手册