示例中心
功能在线体验
控制台
您现在的位置: 开发 > Web服务 API > 开发指南 > API文档 > 天气查询 >

高德 开发 Web服务 API 开发指南 API文档 天气查询

更新时间:2018年06月08日

产品介绍

天气查询是一个简单的HTTP接口,根据用户输入的adcode,查询目标区域当前/未来的天气情况。

使用API前您需先申请Key,若无高德地图API账号需要先申请账号。

适用场景

需要使用相关天气查询的时候。

使用限制

 服务调用量的限制请点击这里查阅。  

使用说明

第一步,申请”web服务 API”密钥(Key);

第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;

第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。

如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。

天气查询

天气查询API服务地址:

http://restapi.amap.com/v3/weather/weatherInfo?parameters  

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

 

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请web服务API类型KEY

必填

city

城市名称

输入adcode

必填

extensions

气象类型

可选值:base/all

base:返回实况天气

all:返回预报天气

可选

output

返回格式

可选值:JSON,XML

可选

JSON

  • 返回结果参数说明

行政区域查询的响应结果的格式由请求参数output指定。

名称

含义

规则说明

status

返回状态

值为0或1

1:成功;0:失败

count

返回结果总数目


info

返回的状态信息


infocode

返回状态说明,10000代表正确


lives

实况天气数据信息



province

省份名



city

城市名



adcode

区域编码



weather

天气现象(汉字描述)



temperature

实时气温,单位:摄氏度



winddirection

风向,风向编码对应描述



windpower

风力,此处返回的是风力编码,风力编码对应风力级别,单位:级



humidity

空气湿度



reporttime

数据发布的时间


forecast

预报天气信息数据



city

城市名称



adcode

城市编码



province

省份名称



reporttime

预报发布时间



casts

预报数据list结构,元素cast,按顺序为当天、第二天、第三天的预报数据




date

日期




week

星期几




dayweather

白天天气现象




nightweather

晚上天气现象




daytemp

白天温度




nighttemp

晚上温度




daywind

白天风向




nightwind

晚上风向




daypower

白天风力




nightpower

晚上风力


-天气现象编码表

编码

天气现象

00

01

多云

02

03

阵雨

04

雷阵雨

05

雷阵雨并伴有冰雹

06

雨夹雪

07

小雨

08

中雨

09

大雨

10

暴雨

11

大暴雨

12

特大暴雨

13

阵雪

14

小雪

15

中雪

16

大雪

17

暴雪

18

19

冻雨

20

沙尘暴

21

小雨-中雨

22

中雨-大雨

23

大雨-暴雨

24

暴雨-大暴雨

25

大暴雨-特大暴雨

26

小雪-中雪

27

中雪-大雪

28

大雪-暴雪

29

浮尘

30

扬沙

31

强沙尘暴

32

33

龙卷风

34

弱高吹雪

35

轻雾

53

-风力编码表

编码

风力(级)

0

<3

1

3~4

2

4~5

3

5~6

4

6~7

5

7~8

6

8~9

7

9~10

8

10~11

9

11~12

-方向编码表

编码

风向

0

无风向

1

东北

2

3

东南

4

5

西南

6

西

7

西北

8

9

旋转不定

  • 服务示例
http://restapi.amap.com/v3/weather/weatherInfo?city=110101&key=<用户key>
参数 备注 必选
city 需要查询天气的城市编码。


移动端
示例中心
功能
在线体验
常见问题