天气查询 最后更新时间: 2023年04月03日
产品介绍
天气查询是一个简单的HTTP接口，根据用户输入的adcode，查询目标区域当前/未来的天气情况，数据来源是中国气象局。
使用API前您需先申请Key，若无高德地图API账号需要先申请账号。
适用场景
需要使用相关天气查询的时候。
使用限制
服务调用量的限制请点击这里查阅。
使用说明
第一步，申请”web服务 API”密钥（Key）；
第二步，拼接HTTP请求URL，第一步申请的Key需作为必填参数一同发送；
第三步，接收HTTP请求返回的数据（JSON或XML格式），解析数据。
如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。
天气查询
天气查询API服务地址：
URL | http://restapi.amap.com/v3/weather/weatherInfo?parameters |
请求方式 | GET |
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
- 请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 | |
|---|---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请web服务API类型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 | 晚上风力 | |||
- 服务示例
http://restapi.amap.com/v3/weather/weatherInfo?city=110101&key=<用户key>| 参数 | 值 | 备注 | 必选 |
|---|---|---|---|
| city | 需要查询天气的城市编码。 | 否 |