实时天气数据API接口-OpenWeather
产品介绍
什么是实时天气数据API接口-OpenWeather?
服务详情
当前天气数据API服务是 OpenWeather 提供的一项服务,旨在向用户提供即时的天气信息。通过该API,用户可以获取特定位置的当前天气状况,包括温度、湿度、气压、风速和风向等信息。
核心功能
- 通过经纬度能够查询特定位置的当前天气信息
- 通过城市id查询特定城市当前天气信息
核心优势
- 全球覆盖:能够获取地球上任何地点的当前天气数据,无论是城市、乡村还是偏远地区,都可以获得实时天气信息。
- 多来源数据:数据来源广泛,包括全球和本地天气模型、卫星、雷达以及庞大的气象站网络。这意味着用户可以获得来自多种数据源的天气信息,提高了数据的准确性和全面性。
- 多格式支持:提供多种数据格式选择,包括 JSON、XML 或 HTML 格式。这样的灵活性使得用户可以根据自己的偏好或应用需求选择合适的数据格式进行使用和处理。
- 实时更新:提供的天气数据是实时更新的,反映了当前地点的最新天气状况。这样的及时性保证了用户获取到的天气信息是最准确、最新的。
- 灵活性:能够满足不同用户的需求,无论是普通用户、开发者还是企业用户,都可以根据自身需求获取和处理天气数据,从而实现各种应用场景。
什么是实时天气数据API接口-OpenWeather接口?
由服务使用方的应用程序发起,以Restful风格为主、通过公网HTTP协议调用实时天气数据API接口-OpenWeather,从而实现程序的自动化交互,提高服务效率。
产品价格
使用指南
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标,或者反之亦然,请使用Geocoder API 。
请注意,内置地理编码器已被弃用。尽管它仍然可以使用,但错误修复和更新不再适用于此功能。
API响应
如果您在 API 响应中没有看到某些参数,则意味着这些天气现象在所选城市或位置的测量时间内并未发生。API 响应中仅显示实际测量或计算的数据。
支持的语言
-
af
南非荷兰语 -
al
阿尔巴尼亚语 -
ar
阿拉伯 -
az
阿塞拜疆语 -
bg
保加利亚语 -
ca
加泰罗尼亚语 -
cz
捷克语 -
da
丹麦语 -
de
德语 -
el
希腊语 -
en
英语 -
eu
巴斯克 -
fa
波斯语(波斯语) -
fi
芬兰 -
fr
法语 -
gl
加利西亚语 -
he
希伯来语 -
hi
印地语 -
hr
克罗地亚语 -
hu
匈牙利 -
id
印度尼西亚 -
it
意大利语 -
ja
日本人 -
kr
韩国人 -
la
拉脱维亚语 -
lt
立陶宛语 -
mk
马其顿语 -
no
挪威 -
nl
荷兰语 -
pl
抛光 -
pt
葡萄牙语 -
pt_br
巴西葡萄牙语 -
ro
罗马尼亚语 -
ru
俄语 -
sv, se
瑞典 -
sk
斯洛伐克语 -
sl
斯洛文尼亚语 -
sp, es
西班牙语 -
sr
塞尔维亚 -
th
泰国 -
tr
土耳其 -
ua, uk
乌克兰 -
vi
越南语 -
zh_cn
简体中文 -
zh_tw
中国传统的 -
zu
祖鲁语
产品问答
?
是否支持多语言输出?
您可以使用lang 参数以您的语言获取输出。对城市名称和描述字段应用翻译。
?
响应格式是否支持不同格式输出?
默认使用 JSON 格式。要获取 XML 格式的数据,只需设置 mode = xml。
关于我们
OpenWeather
企业
OpenWeather是一个由IT专家和数据科学家组成的团队,一直在实践深度天气数据科学。对于地球上的每一个点,OpenWeather通过光速api提供历史、当前和预测的天气数据。总部设在GB伦敦。
联系信息
服务时间: 0:00:00至24:00:00
邮箱: info@openweathermap.org
API接口列表
获取当前天气数据
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": "错误"
}
产品价格
使用指南
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标,或者反之亦然,请使用Geocoder API 。
请注意,内置地理编码器已被弃用。尽管它仍然可以使用,但错误修复和更新不再适用于此功能。
API响应
如果您在 API 响应中没有看到某些参数,则意味着这些天气现象在所选城市或位置的测量时间内并未发生。API 响应中仅显示实际测量或计算的数据。
支持的语言
-
af
南非荷兰语 -
al
阿尔巴尼亚语 -
ar
阿拉伯 -
az
阿塞拜疆语 -
bg
保加利亚语 -
ca
加泰罗尼亚语 -
cz
捷克语 -
da
丹麦语 -
de
德语 -
el
希腊语 -
en
英语 -
eu
巴斯克 -
fa
波斯语(波斯语) -
fi
芬兰 -
fr
法语 -
gl
加利西亚语 -
he
希伯来语 -
hi
印地语 -
hr
克罗地亚语 -
hu
匈牙利 -
id
印度尼西亚 -
it
意大利语 -
ja
日本人 -
kr
韩国人 -
la
拉脱维亚语 -
lt
立陶宛语 -
mk
马其顿语 -
no
挪威 -
nl
荷兰语 -
pl
抛光 -
pt
葡萄牙语 -
pt_br
巴西葡萄牙语 -
ro
罗马尼亚语 -
ru
俄语 -
sv, se
瑞典 -
sk
斯洛伐克语 -
sl
斯洛文尼亚语 -
sp, es
西班牙语 -
sr
塞尔维亚 -
th
泰国 -
tr
土耳其 -
ua, uk
乌克兰 -
vi
越南语 -
zh_cn
简体中文 -
zh_tw
中国传统的 -
zu
祖鲁语
依赖服务
产品问答
?
是否支持多语言输出?
您可以使用lang 参数以您的语言获取输出。对城市名称和描述字段应用翻译。
?
响应格式是否支持不同格式输出?
默认使用 JSON 格式。要获取 XML 格式的数据,只需设置 mode = xml。
关于我们
OpenWeather
企业
OpenWeather是一个由IT专家和数据科学家组成的团队,一直在实践深度天气数据科学。对于地球上的每一个点,OpenWeather通过光速api提供历史、当前和预测的天气数据。总部设在GB伦敦。
联系信息