产品介绍

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

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

适用场景

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

使用限制

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

使用说明

第一步，申请”web服务 API”密钥(Key)；

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

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

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

天气查询

天气查询API服务地址：

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

请求方式GET

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

参数名含义规则说明是否必须缺省值

key请求服务权限标识必填无

city城市编码输入城市的adcode，adcode信息可参考城市编码表必填无

extensions气象类型可选值：base/all

base:返回实况天气

all:返回预报天气可选无

output返回格式可选值：JSON,XML可选JSON返回结果参数说明

实况天气每小时更新多次，预报天气每天更新3次，分别在8、11、18点左右更新。由于天气数据的特殊性以及数据更新的持续性，无法确定精确的更新时间，请以接口返回数据的reporttime字段为准。天气结果对照表>>

名称含义规则说明

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晚上风力服务示例https://restapi.amap.com/v3/weather/weatherInfo?city=110101&key=

参数 值 备注 必选 city 需要查询天气的城市编码。 否