获取当前天气数据
1.1 简要描述
根据纬度获取当前位置天气信息
1.2 请求URL
https://api.openweathermap.org/data/2.5/weather
1.3 请求方式
POST
1.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
lat |
String |
|
是 |
纬度 |
lon |
String |
|
是 |
经度 |
appid |
String |
|
是 |
您唯一的 |
mode |
String |
|
否 |
响应格式。可能的值为xml和html。如果不使用mode参数格式默认为JSON。 |
units |
String |
|
否 |
测量单位。standard,metric并且imperial |
lang |
String |
|
否 |
您可以使用此参数获取您的语言的输出。 |
1.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
coord.lon |
String |
|
地点的经度 |
coord.lat |
String |
|
地点的纬度 |
weather.id |
String |
|
天气状况 |
weather.main |
String |
|
天气参数组(雨、雪、云等) |
weather.description |
String |
|
团体内的天气状况。请在这里找到更多信息。您可以获得您的语言的输出。了解更多 |
weather.icon |
String |
|
天气图标 |
base |
String |
|
内部参数 |
main.temp |
String |
|
温度。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
main.feels_like |
String |
|
温度。该温度参数解释了人类对天气的感知。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
main.pressure |
String |
|
海平面大气压,hPa |
main.humidity |
String |
|
湿度, |
main.temp_min |
String |
|
目前最低温度。这是目前观测到的最低温度(在大都市和城市地区)。请在此处查找更多信息。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
main.temp_max |
String |
|
当前最高温度。这是目前观测到的最高温度(在大都市和城市地区)。请在此处查找更多信息。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
main.sea_level |
String |
|
海平面大气压,hPa |
main.grnd_level |
String |
|
地面大气压,hPa |
visibility |
String |
|
能见度,米。能见度最大值为10公里 |
wind.speed |
String |
|
风速。单位默认:米/秒,公制:米/秒,英制:英里/小时 |
wind.deg |
String |
|
风向、度(气象) |
wind.gust |
String |
|
阵风。单位默认:米/秒,公制:米/秒,英制:英里/小时 |
clouds.all |
String |
|
云度,% |
rain.1h |
String |
|
(如果有)过去 |
rain.3h |
String |
|
(如果有)过去 |
snow.1h |
String |
|
(如果有)过去 |
snow.3h |
String |
|
(如果有)过去 |
dt |
String |
|
数据计算时间,unix,UTC |
sys.type |
String |
|
内部参数 |
sys.id |
String |
|
内部参数 |
sys.message |
String |
|
内部参数 |
sys.country |
String |
|
国家代码(GB、JP |
sys.sunrise |
String |
|
日出时间,unix,UTC |
sys.sunset |
String |
|
日落时间,unix,UTC |
timezone |
String |
|
与UTC |
id |
String |
|
城市ID。 |
name |
String |
|
城市名。 |
cod |
String |
|
内部参数 |
1.6 错误码
错误码 |
错误信息 |
描述 |
400 |
错误 |
400 |
401 |
错误 |
401 |
404 |
未找到错误404。 |
如果服务数据库中不存在请求参数(lat、等)的数据,您可能会收到 |
429 |
错误 |
429 |
5xx |
错误 |
5xx |
1.7 示例
请求参数{
"lat": "",
"lon": "",
"appid": "",
"mode": "",
"units": "",
"lang": ""
}
返回参数
{
"coord.lon": "地点的经度",
"coord.lat": "",
"weather.id": "",
"weather.main": "",
"weather.description": "",
"weather.icon": "",
"base": "",
"main.temp": "",
"main.feels_like": "",
"main.pressure": "",
"main.humidity": "",
"main.temp_min": "",
"main.temp_max": "",
"main.sea_level": "",
"main.grnd_level": "",
"visibility": "",
"wind.speed": "",
"wind.deg": "",
"wind.gust": "",
"clouds.all": "",
"rain.1h": "",
"rain.3h": "",
"snow.1h": "",
"snow.3h": "",
"dt": "",
"sys.type": "",
"sys.id": "",
"sys.message": "",
"sys.country": "",
"sys.sunrise": "",
"sys.sunset": "",
"timezone": "",
"id": "",
"name": "",
"cod": ""
}
错误码
{
"400": "错误",
"401": "错误",
"404": "未找到错误404。如果服务数据库中不存在请求参数(",
"429": "错误",
"5xx": "错误"
}