一、请求接口
High德提供了完善的API服务，其中包括天气API服务。用户可以使用高德天气API来获取实时天气情况、未来天气预报、空气质量、天气灾害预警等信息。下面是一个请求示例：
https://restapi.amap.com/v3/weather/weatherInfo?city=深圳市&key=你的Key值
其中，city表示要查询的城市，key是开发者的授权码。
二、获取实时天气情况
高德天气API可以提供实时天气情况，包括温度、湿度、风向、风速等。使用以下请求格式：
https://restapi.amap.com/v3/weather/weatherInfo?city=深圳市&key=你的Key值&extensions=base
其中，extensions=base表示只获取基本天气信息。返回结果如下：
{
"status": "1",
"count": "1",
"info": "OK",
"infocode": "10000",
"lives": [
{
"province": "广东",
"city": "深圳市",
"adcode": "440300",
"weather": "多云",
"temperature": "30",
"winddirection": "东南",
"windpower": "≤3",
"humidity": "74",
"reporttime": "2021-08-04 10:19:16"
}
]
}
可以看到，返回结果中包含省份、城市、天气、温度、湿度、风向、风速等信息。
三、获取未来天气预报
高德天气API还提供了天气预报功能，可以查询未来几天的天气情况。使用以下请求格式：
https://restapi.amap.com/v3/weather/weatherInfo?city=深圳市&key=你的Key值&extensions=all
其中，extensions=all表示获取详细天气信息。返回结果如下：
{
"status": "1",
"count": "1",
"info": "OK",
"infocode": "10000",
"forecasts": [
{
"city": "深圳市",
"adcode": "440300",
"province": "广东",
"reporttime": "2021-08-04 10:38:16",
"casts": [
{
"date": "2021-08-04",
"week": "三",
"dayweather": "多云",
"nightweather": "多云",
"daytemp": "31",
"nighttemp": "27",
"daywind": "南",
"nightwind": "南",
"daypower": "≤3",
"nightpower": "≤3"
},
{
"date": "2021-08-05",
"week": "四",
"dayweather": "阴",
"nightweather": "小雨",
"daytemp": "30",
"nighttemp": "26",
"daywind": "南",
"nightwind": "南",
"daypower": "≤3",
"nightpower": "≤3"
},
...
]
}
]
}
可以看到，返回结果中每天的天气情况都包含了日期、星期、白天天气、夜晚天气、白天温度、夜晚温度、白天风向、夜晚风向、白天风速、夜晚风速等信息。
四、获取空气质量
高德天气API还可以提供空气质量信息，使用以下请求格式：
https://restapi.amap.com/v3/weather/weatherInfo?city=深圳市&key=你的Key值&extensions=all&output=json
其中，extensions=all表示获取详细天气信息，output=json表示输出结果为json格式。返回结果如下：
{
"status": "1",
"count": "1",
"info": "OK",
"infocode": "10000",
"forecasts": [
{
"city": "深圳市",
"adcode": "440300",
"province": "广东",
"reporttime": "2021-08-04 11:00:00",
"casts": [
{
"date": "2021-08-04",
"week": "三",
"dayweather": "多云",
"nightweather": "多云",
"daytemp": "31",
"nighttemp": "27",
"daywind": "南",
"nightwind": "南",
"daypower": "≤3",
"nightpower": "≤3",
"aqi": "86",
"quality": "良",
"pm2_5": "58",
"pm10": "86",
"so2": "11",
"co": "0.5",
"o3": "92",
"no2": "14",
"primarypollutant": ""
},
...
]
}
]
}
可以看到，返回结果中包含了空气质量情况、AQI指数、PM2.5、PM10、SO2、CO、O3和NO2等信息。
五、获取天气灾害预警
高德天气API还提供了灾害天气预警功能，包括暴雨、台风、沙尘暴、大雾、高温等天气情况。使用以下请求格式：
https://restapi.amap.com/v3/weather/weatherInfo?city=深圳市&key=你的Key值&extensions=all&output=json&limit=5
其中，extensions=all表示获取详细天气信息，output=json表示输出结果为json格式，limit=5表示返回五条最新的预警信息。返回结果如下：
{
"status": "1",
"count": "5",
"info": "OK",
"infocode": "10000",
"alarms": [
{
"name": "暴雨蓝色预警",
"adcode": "440300",
"level": "蓝色",
"status": "预警中",
"tips": "注意防范",
"time": "2021-08-08 15:45:00"
},
{
"name": "暴雨橙色预警",
"adcode": "440300",
"level": "橙色",
"status": "预警中",
"tips": "请提前做好防护措施",
"time": "2021-08-08 15:45:00"
},
...
]
}
可以看到，返回结果中包含了预警名称、预警级别、预警状态、预警提示、预警时间等信息。