产品介绍
天气查询是一个简单的HTTP接口,根据用户输入的adcode,查询目标区域当前/未来的天气情况。
使用API前您需先申请Key,若无高德地图API账号需要先申请账号。
适用场景
需要使用相关天气查询的时候。
使用限制
服务调用量的限制请点击这里查阅。
使用说明
第一步,申请”web服务 API”密钥(Key);
第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;
第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。
天气查询
天气查询API服务地址:
URL/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晚上风力服务示例/v3/weather/weatherInfo?city=110101&key=
参数 值 备注 必选 city 需要查询天气的城市编码。 否
如果觉得《android高德天气api接口 天气查询-API文档-开发指南-Web服务 API | 高德地图API》对你有帮助,请点赞、收藏,并留下你的观点哦!