未来5天的天气数据
1.1 简要描述
通过经纬度来获取全球任何地点未来5天的天气数据
1.2 请求URL
https://api.openweathermap.org/data/2.5/forecast
1.3 请求方式
POST
1.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
lat |
string |
|
是 |
纬度。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之,请使用我们的地理编码 |
lon |
string |
|
是 |
经度。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之,请使用我们的地理编码 |
appid |
string |
|
是 |
您唯一的 |
units |
string |
|
否 |
测量单位。standard,metric并且imperial单位可用。如果不使用该units参数,standard则默认使用单位。 |
mode |
string |
|
否 |
响应格式。默认使用 |
cnt |
string |
|
否 |
许多时间戳,将在 |
units |
string |
|
否 |
测量单位。standard,metric并且imperial单位可用。如果不使用该units参数,standard则默认使用单位。 |
lang |
string |
|
否 |
您可以使用该lang参数来获取您的语言的输出。 |
1.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
cod |
String |
|
内部参数 |
message |
String |
|
内部参数 |
cntAPI |
String |
|
响应中返回的时间戳数量 |
list.dt |
String |
|
预测数据时间,unix,UTC |
list.main.temp |
String |
|
温度。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
list.main.feels_like |
String |
|
该温度参数解释了人类对天气的感知。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
list.main.temp_min |
String |
|
计算时的最低温度。这是最低预测温度(在大都市和城市地区内),可以选择使用此参数。请在此处查找更多信息。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
list.main.temp_max |
String |
|
计算时的最高温度。这是最高预测温度(在大都市和城市地区内),可以选择使用此参数。请在此处查找更多信息。单位默认:开尔文,公制:摄氏度,英制:华氏度 |
list.main.pressure |
String |
|
默认海平面大气压,hPa |
list.main.sea_level |
String |
|
海平面大气压,hPa |
list.main.grnd_level |
String |
|
地面大气压,hPa |
list.main.humidity |
String |
|
湿度, |
list.main.temp_kf |
String |
|
内部参数 |
list.weather.id |
String |
|
天气状况 |
list.weather.main |
String |
|
天气参数组(雨、雪、云等) |
list.weather.description |
String |
|
团体内的天气状况。请在这里找到更多信息。您可以获得您的语言的输出。了解更多 |
list.weather.icon |
String |
|
天气图标 |
list.clouds.all |
String |
|
云度,% |
list.wind.speed |
String |
|
风速。单位默认:米/秒,公制:米/秒,英制:英里/小时 |
list.wind.deg |
String |
|
风向,度(气象) |
list.wind.gust |
String |
|
阵风。单位默认:米/秒,公制:米/秒,英制:英里/小时 |
list.visibility |
String |
|
平均能见度,米。能见度最大值为10公里 |
list.pop |
String |
|
降水的概率。该参数的值在 |
list.rain.3h |
String |
|
最近 |
list.snow.3h |
String |
|
过去 |
list.sys.pod |
String |
|
一天中的一部分(n |
list.dt_txt |
String |
|
数据预测时间、ISO、UTC |
city.id |
String |
|
城市 |
city.name |
String |
|
城市名。请注意,内置地理编码器功能已被弃用。在这里了解更多 |
city.coord.lat |
String |
|
地理位置、纬度 |
city.coord.lon |
String |
|
地理位置、经度 |
city.country |
String |
|
国家代码(GB、JP |
city.population |
String |
|
城市人口 |
city.timezone |
String |
|
与UTC |
city.sunrise |
String |
|
日出时间,Unix,UTC |
city.sunset |
String |
|
日落时间,Unix,UTC |
1.6 错误码
错误码 |
错误信息 |
描述 |
400 |
错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 |
|
401 |
未经授权。如果请求中未提供 |
|
404 |
如果服务数据库中不存在请求参数( |
|
429 |
请求过多。如果超出了向此 |
|
5xx |
意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 |
|
1.7 示例
请求参数{
"lat": "",
"lon": "",
"appid": "",
"units": "",
"mode": "",
"cnt": "",
"lang": ""
}
返回参数
{
"cod": "",
"message": "",
"cntAPI": "",
"list.dt": "",
"list.main.temp": "",
"list.main.feels_like": "",
"list.main.temp_min": "",
"list.main.temp_max": "",
"list.main.pressure": "",
"list.main.sea_level": "",
"list.main.grnd_level": "",
"list.main.humidity": "",
"list.main.temp_kf": "",
"list.weather.id": "",
"list.weather.main": "",
"list.weather.description": "",
"list.weather.icon": "",
"list.clouds.all": "",
"list.wind.speed": "",
"list.wind.deg": "",
"list.wind.gust": "",
"list.visibility": "",
"list.pop": "",
"list.rain.3h": "",
"list.snow.3h": "",
"list.sys.pod": "",
"list.dt_txt": "",
"city.id": "",
"city.name": "",
"city.coord.lat": "",
"city.coord.lon": "",
"city.country": "",
"city.population": "",
"city.timezone": "",
"city.sunrise": "",
"city.sunset": ""
}
错误码
{
"400": "错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到",
"401": "未经授权。如果请求中未提供",
"404": "如果服务数据库中不存在请求参数(",
"429": "请求过多。如果超出了向此",
"5xx": "意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的"
}