天气查询最后更新时间: 2024年08月06日

产品介绍

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

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

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

第一步

申请【Web服务API】密钥（Key）

第二步

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

第三步

接收 HTTP 请求返回的数据（JSON 或 XML 格式），解析数据

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

成为开发者并创建 Key

为了正常调用 Web 服务 API ，请先注册成为高德开放平台开发者，并申请 Web 服务的 key ，点击具体操作。

URL	请求方式
https://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	晚上风力

https://restapi.amap.com/v3/weather/weatherInfo?city=110101&key=<用户key>

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