使用高德查询天气
1.背景
使用高德API查询指定城市的天气
2.思考-高德开放平台
查看高德官方文档学习使用API查询指定城市的天气状况< https://lbs.amap.com/api/webservice/guide/api/weatherinfo >
3.申请高德开发者web服务身份标识key
步骤请参考< https://blog.csdn.net/chenwen112/article/details/102910437 >
注:
申请key的时候要注意,web服务和web端的key不是一回事,否则会报错.
4.按照官方文档拼接URL
第一步,申请”web服务 API”密钥(Key);
第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;
第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。
5. 天气查询API服务地址:
URL < https://restapi.amap.com/v3/weather/weatherInfo?parameters > 请求方式 GET
6.请求路径中的参数说明
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 |
---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请web服务API类型KEY | 必填 | 无 |
city | 城市编码 | 输入城市的adcode,adcode信息可参考城市编码表 | 必填 | 无 |
extensions | 气象类型 | 可选值:base/all base:返回实况天气 all:返回预报天气 | 可选 | 无 |
output | 返回格式 | 可选值:JSON,XML | 可选 | JSON |
7.返回结果说明
实况天气每小时更新多次,预报天气每天更新3次,分别在8、11、18点左右更新。由于天气数据的特殊性以及数据更新的持续性,无法确定精确的更新时间,请以接口返回数据的reporttime字段为准。[天气结果对照表>>] < https://lbs.amap.com/api/webservice/guide/tools/weather-code/ >
名称 | 含义 | 规则说明 | ||
status | 返回状态 | 值为0或11:成功;0:失败 | ||
count | 返回结果总数目 | |||
info | 返回的状态信息 | |||
infocode | 返回状态说明,10000代表正确 | |||
lives | 实况天气数据信息 | |||
province | 省份名 | |||
city | 城市名 | |||
adcode | 区域编码 | |||
weather | 天气现象(汉字描述) | |||
temperature | 实时气温,单位:摄氏度 | |||