天气预报服务-OpenWeather
什么是天气预报服务-OpenWeather?
服务详情
我们的产品旨在提供简便、全面的天气数据服务,以满足用户对准确、及时天气信息的需求。通过结合 OpenWeather One Call API 3.0 的强大功能,我们为用户提供了一种无缝迁移从 Dark Sky API 的解决方案,并且更进一步地提供了更丰富的功能和数据。
核心功能
- 当前和预报的天气数据查询服务
- 时间戳天气数据查询服务
- 每日汇总数据查询服务
核心优势
全面的数据覆盖:通过 One Call API 3.0,用户可以轻松地获取当前天气情况、短期和长期预报,以及政府天气警报等重要信息。不仅如此,我们还提供了过去40多年历史存档的天气数据,以及未来1.5年的预测,满足用户对历史数据和长期趋势的需求。
高频更新:我们的 API 每10分钟更新一次,以确保用户获得最准确、最新的天气数据。这种高频率的更新确保了用户可以及时获取到最近的天气变化,做出相应的决策。
简单易用:我们的产品设计注重简洁易用,用户可以轻松地通过 API 获取所需的数据,无需繁琐的配置或操作。API 的三个端点提供了不同层次和时间范围的数据,满足不同用户的需求。
什么是天气预报服务-OpenWeather接口?
使用步骤
1. 注册 OpenWeather 服务:如果您尚未获得 OpenWeather API 密钥,请注册 OpenWeather 服务。您可以访问 OpenWeather 网站注册并获取 API 密钥。同时,查看定价页面以了解有关价格的详细信息。
2. 订阅 One Call API 3.0:One Call API 3.0 是一个单独的产品,您需要单独订阅。您只需根据对该产品进行的 API 调用次数付费。默认情况下,每天对该产品的 API 调用次数限制为 2000 次。如果您需要更改此限制,请转到个人帐户中的“计费计划”选项卡以更新设置。
3. 获取 API 密钥:在注册后,您将获得一个 API 密钥,您需要在 API 调用中使用该密钥以获取数据。确保在每次 API 调用中都添加您的 API 密钥。
4. 选择数据类型:根据您的需求选择所需的数据类型。您可以获取当前天气、预测天气数据、时间戳天气数据以及每日汇总天气数据。
5. 进行 API 调用:根据您所选的数据类型和相关技术文档,构建 API 调用。
根据文档中的指示,使用以下终端进行 API 调用:
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}
确保将 `{lat}` 和 `{lon}` 替换为您所需地理位置的纬度和经度,并将 `{API key}` 替换为您获得的 API 密钥。
6. 处理 API 响应:收到 API 响应后,您可以解析数据并根据您的应用需求进行处理和显示。
通过遵循以上步骤,您就可以开始使用 OpenWeather One Call API 3.0 来获取天气数据,并将其集成到您的应用程序中。
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标,或者反之亦然,请使用Geocoder 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
祖鲁语
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
---|---|---|---|---|
lat |
String |
是 |
纬度,十进制 (-90; 90)。 |
|
lon |
String |
是 |
经度,十进制(-180;180)。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之 |
|
appid |
String |
是 |
您唯一的 API 密钥(您始终可以在帐户页面的“API 密钥”选项卡下找到它) |
|
exclude |
String |
否 |
通过使用此参数,您可以从 API 响应中排除部分天气数据。它应该是一个以逗号分隔的列表(不含空格)。 可用值: current minutely hourly daily alerts |
|
units |
String |
是 |
测量单位。standard,metric并且imperial 单位可用。如果不使用该units参数, standard则默认使用单位。 |
|
lang |
String |
是 |
您可以使用该lang参数来获取您的语言的输出。 |
参数名 |
参数类型 |
默认值 |
描述 |
---|---|---|---|
lat |
String |
位置的纬度,十进制 |
|
lon |
String |
位置经度,十进制(-180;180) |
|
timezone |
String |
请求位置的时区名称 |
|
timezone_offset |
String |
与 |
|
current |
String |
当前天气数据API响应 |
|
current.dt |
String |
当前时间,Unix,UTC |
|
current.sunrise |
String |
日出时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
current.sunset |
String |
日落时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
current.temp |
String |
温度。单位 |
|
current.feels_like |
String |
温度。该温度参数解释了人类对天气的感知。单位 |
|
current.pressure |
String |
海平面大气压,hPa |
|
current.humidity |
String |
湿度, |
|
current.dew_point |
String |
大气温度(根据压力和湿度而变化),低于该温度水滴开始凝结并形成露水。单位 |
|
current.clouds |
String |
云度,% |
|
current.uvi |
String |
当前紫外线指数。 |
|
current.visibility |
String |
平均能见度,米。能见度最大值为10公里 |
|
current.wind_speed |
String |
风速。风速。单位 |
|
current.wind_gust |
String |
(如有)阵风。单位 |
|
current.wind_deg |
String |
风向,度(气象) |
|
current.rain |
String |
||
current.rain.1h |
String |
(如有) |
|
current.snow |
String |
||
current.snow.1h |
String |
(如有) |
|
current.weather |
String |
||
current.weather.id |
String |
天气状况 |
|
current.weather.main |
String |
天气参数组(雨、雪等) |
|
current.weather.description |
String |
团体内的天气状况(天气状况的完整列表)。获取您语言的输出 |
|
current.weather.icon |
String |
天气图标 |
|
minutely |
String |
分钟预报天气数据 |
|
minutely.dt |
String |
预测数据的时间,unix,UTC |
|
minutely.precipitation |
String |
降水量,毫米/小时。请注意,此参数仅可使用 |
|
hourly |
String |
每小时预报天气数据API响应 |
|
hourly.dt |
String |
预测数据的时间,Unix,UTC |
|
hourly.temp |
String |
温度。单位 |
|
hourly.feels_like |
String |
温度。这解释了人类对天气的感知。单位 |
|
hourly.pressure |
String |
海平面大气压,hPa |
|
hourly.humidity |
String |
湿度, |
|
hourly.dew_point |
String |
大气温度(根据压力和湿度而变化),低于该温度水滴开始凝结并形成露水。单位 |
|
hourly.uvi |
String |
紫外线指数 |
|
hourly.clouds |
String |
云度,% |
|
hourly.visibility |
String |
平均能见度,米。能见度最大值为10公里 |
|
hourly.wind_speed |
String |
风速。单位 |
|
hourly.wind_gust |
String |
(如有)阵风。单位 |
|
hourly.wind_deg |
String |
风向,度(气象) |
|
hourly.pop |
String |
降水的概率。该参数的值在 |
|
hourly.rain |
String |
||
hourly.rain.1h |
String |
(如有) |
|
hourly.snow |
String |
||
hourly.snow.1h |
String |
(如有) |
|
hourly.weather |
String |
||
hourly.weather.id |
String |
天气状况 |
|
hourly.weather.main |
String |
天气参数组(雨、雪等) |
|
hourly.weather.description |
String |
团体内的天气状况(天气状况的完整列表)。获取您语言的输出 |
|
hourly.weather.icon |
String |
天气图标 |
|
daily |
String |
每日预报天气数据API响应 |
|
daily.dt |
String |
预测数据的时间,Unix,UTC |
|
daily.sunrise |
String |
日出时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
daily.sunset |
String |
日落时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
daily.moonrise |
String |
这一天月亮升起的时间,Unix,UTC |
|
daily.moonset |
String |
这一天月亮落下的时间,Unix,UTC |
|
daily.moon_phase |
String |
月相。0分别1是“新月”、0.25“上弦月”、0.5“满月”和 |
|
summary |
String |
当天天气状况的人类可读描述 |
|
daily.temp |
String |
单位 |
|
daily.temp.morn |
String |
早晨的温度。 |
|
daily.temp.day |
String |
白天温度。 |
|
daily.temp.eve |
String |
晚上的温度。 |
|
daily.temp.night |
String |
夜间温度。 |
|
daily.temp.min |
String |
每日最低温度。 |
|
daily.temp.max |
String |
每日最高温度。 |
|
daily.feels_like |
String |
这解释了人类对天气的感知。单位 |
|
daily.feels_like.morn |
String |
早晨的温度。 |
|
daily.feels_like.day |
String |
白天温度。 |
|
daily.feels_like.eve |
String |
晚上的温度。 |
|
daily.feels_like.night |
String |
夜间温度。 |
|
daily.pressure |
String |
海平面大气压,hPa |
|
daily.humidity |
String |
湿度, |
|
daily.dew_point |
String |
大气温度(根据压力和湿度而变化),低于该温度水滴开始凝结并形成露水。单位 |
|
daily.wind_speed |
String |
风速。单位 |
|
daily.wind_gust |
String |
(如有)阵风。单位 |
|
daily.wind_deg |
String |
风向,度(气象) |
|
daily.clouds |
String |
云度,% |
|
daily.uvi |
String |
当日紫外线指数最大值 |
|
daily.pop |
String |
降水的概率。该参数的值在 |
|
daily.rain |
String |
(如有)降水量,毫米。请注意,该参数仅可使用 |
|
daily.snow |
String |
(如有)雪量,毫米。请注意,该参数仅可使用 |
|
daily.weather |
String |
||
daily.weather.id |
String |
天气状况 |
|
daily.weather.main |
String |
天气参数组(雨、雪等) |
|
daily.weather.description |
String |
团体内的天气状况(天气状况的完整列表)。获取您语言的输出 |
|
daily.weather.icon |
String |
天气图标 |
|
alerts |
String |
来自主要国家天气预警系统的国家天气警报数据 |
|
alerts.sender_name |
String |
警报源的名称。请在此处阅读警报源的完整列表 |
|
alerts.event |
String |
警报事件名称 |
|
alerts.start |
String |
警报开始的日期和时间,Unix,UTC |
|
alerts.end |
String |
警报结束的日期和时间,Unix,UTC |
|
alerts.description |
String |
警报的描述 |
|
alerts.tags |
String |
恶劣天气类型 |
|
cod |
String |
错误代码 |
|
message |
String |
错误描述 |
|
parameters |
String |
(可选)与此特定错误相关的请求参数名称列表 错误列表 |
错误码 |
错误信息 |
描述 |
---|---|---|
400 |
错误 400 - 错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 400 错误。所有缺失或不正确的参数名称列表将在“ErrorResponse”对象的“parameters”属性中返回。 |
|
401 |
错误 401 - 未经授权。如果请求中未提供 API 令牌,或者请求中提供的 API 令牌未授予对此 API 的访问权限,您可能会收到 401 错误。在返回请求之前,您必须将具有产品访问权限的 API 令牌添加到请求中。 |
|
404 |
未找到错误404。如果服务数据库中不存在请求参数( lat、等)的数据,您可能会收到 404 错误lon。date您不得重试同一请求。 |
|
429 |
错误 429 - 请求过多。如果超出了向此 API 提供的 API 请求的关键配额,您可能会收到 429 错误。您可以在一段时间后或延长密钥配额后重试请求。 |
|
5xx |
错误 5xx - 意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 API 请求示例附在您的电子邮件中,以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。 |
请求参数{
"lat": null,
"lon": null,
"appid": null,
"exclude": null,
"units": null,
"lang": null
}
返回参数
{
"lat": null,
"lon": null,
"timezone": null,
"timezone_offset": null,
"current": null,
"current.dt": null,
"current.sunrise": null,
"current.sunset": null,
"current.temp": null,
"current.feels_like": null,
"current.pressure": null,
"current.humidity": null,
"current.dew_point": null,
"current.clouds": null,
"current.uvi": null,
"current.visibility": null,
"current.wind_speed": null,
"current.wind_gust": null,
"current.wind_deg": null,
"current.rain": null,
"current.rain.1h": null,
"current.snow": null,
"current.snow.1h": null,
"current.weather": null,
"current.weather.id": null,
"current.weather.main": null,
"current.weather.description": null,
"current.weather.icon": null,
"minutely": null,
"minutely.dt": null,
"minutely.precipitation": null,
"hourly": null,
"hourly.dt": null,
"hourly.temp": null,
"hourly.feels_like": null,
"hourly.pressure": null,
"hourly.humidity": null,
"hourly.dew_point": null,
"hourly.uvi": null,
"hourly.clouds": null,
"hourly.visibility": null,
"hourly.wind_speed": null,
"hourly.wind_gust": null,
"hourly.wind_deg": null,
"hourly.pop": null,
"hourly.rain": null,
"hourly.rain.1h": null,
"hourly.snow": null,
"hourly.snow.1h": null,
"hourly.weather": null,
"hourly.weather.id": null,
"hourly.weather.main": null,
"hourly.weather.description": null,
"hourly.weather.icon": null,
"daily": null,
"daily.dt": null,
"daily.sunrise": null,
"daily.sunset": null,
"daily.moonrise": null,
"daily.moonset": null,
"daily.moon_phase": null,
"summary": null,
"daily.temp": null,
"daily.temp.morn": null,
"daily.temp.day": null,
"daily.temp.eve": null,
"daily.temp.night": null,
"daily.temp.min": null,
"daily.temp.max": null,
"daily.feels_like": null,
"daily.feels_like.morn": null,
"daily.feels_like.day": null,
"daily.feels_like.eve": null,
"daily.feels_like.night": null,
"daily.pressure": null,
"daily.humidity": null,
"daily.dew_point": null,
"daily.wind_speed": null,
"daily.wind_gust": null,
"daily.wind_deg": null,
"daily.clouds": null,
"daily.uvi": null,
"daily.pop": null,
"daily.rain": null,
"daily.snow": null,
"daily.weather": null,
"daily.weather.id": null,
"daily.weather.main": null,
"daily.weather.description": null,
"daily.weather.icon": null,
"alerts": null,
"alerts.sender_name": null,
"alerts.event": null,
"alerts.start": null,
"alerts.end": null,
"alerts.description": null,
"alerts.tags": null,
"cod": "",
"message": "",
"parameters": ""
}
错误码
{
"400": "错误 400 - 错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 400 错误。所有缺失或不正确的参数名称列表将在“ErrorResponse”对象的“parameters”属性中返回。",
"401": "错误 401 - 未经授权。如果请求中未提供 API 令牌,或者请求中提供的 API 令牌未授予对此 API 的访问权限,您可能会收到 401 错误。在返回请求之前,您必须将具有产品访问权限的 API 令牌添加到请求中。",
"404": "未找到错误404。如果服务数据库中不存在请求参数( lat、等)的数据,您可能会收到 404 错误lon。date您不得重试同一请求。",
"429": "错误 429 - 请求过多。如果超出了向此 API 提供的 API 请求的关键配额,您可能会收到 429 错误。您可以在一段时间后或延长密钥配额后重试请求。",
"5xx": "错误 5xx - 意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 API 请求示例附在您的电子邮件中,以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。"
}
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
---|---|---|---|---|
lat |
是 |
纬度,十进制 |
||
lon |
是 |
经度,十进制(-180;180)。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之,请使用我们的地理编码 |
||
dt |
是 |
时间戳(Unix时间,UTC时区),例如dt=1586468027。数据提供时间为 |
||
appid |
是 |
您唯一的 |
||
units |
否 |
测量单位。standard,metric并且imperial |
||
lang |
否 |
您可以使用该lang参数来获取您的语言的输出。 |
参数名 |
参数类型 |
默认值 |
描述 |
---|---|---|---|
lat |
String |
位置的纬度,十进制 |
|
lon |
String |
位置经度,十进制(-180;180) |
|
timezone |
String |
请求位置的时区名称 |
|
timezone_offset |
String |
与UTC |
|
data |
String |
||
data.dt |
String |
请求的时间、Unix、UTC |
|
data.sunrise |
String |
日出时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
data.sunset |
String |
日落时间,Unix,UTC。对于午夜阳光和极夜时段的极地地区,响应中不会返回此参数 |
|
data.temp |
String |
温度。单位 |
|
data.feels_like |
String |
温度。这解释了人类对天气的感知。单位 |
|
data.pressure |
String |
海平面大气压,hPa |
|
data.humidity |
String |
湿度, |
|
data.dew_point |
String |
大气温度(根据压力和湿度而变化),低于该温度水滴开始凝结并形成露水。单位 |
|
data.clouds |
String |
云度,% |
|
data.uvi |
String |
紫外线指数。请注意,历史紫外线指数数据仅提供 |
|
data.visibility |
String |
平均能见度,米。能见度最大值为10公里 |
|
data.wind_speed |
String |
风速。单位 |
|
data.wind_gust |
String |
(如有)阵风。风速。单位 |
|
data.wind_deg |
String |
风向,度(气象) |
|
data.weather |
String |
||
data.weather.id |
String |
天气状况 |
|
data.weather.main |
String |
天气参数组(雨、雪等) |
|
data.weather.description |
String |
团体内的天气状况(天气状况的完整列表)。获取您语言的输出 |
|
data.weather.icon |
String |
天气图标 |
|
data.rain |
String |
(如有)1h降水量,毫米/小时。请注意,此参数仅可使用 |
|
data.snow |
String |
(如有)1h降水量,毫米/小时。请注意,此参数仅可使用 |
|
cod |
String |
错误代码 |
|
message |
String |
错误描述 |
|
parameters |
String |
(可选)与此特定错误相关的请求参数名称列表 |
错误码 |
错误信息 |
描述 |
---|---|---|
400 |
错误 400 - 错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 400 错误。所有缺失或不正确的参数名称列表将在“ErrorResponse”对象的“parameters”属性中返回。 |
|
401 |
错误 401 - 未经授权。如果请求中未提供 API 令牌,或者请求中提供的 API 令牌未授予对此 API 的访问权限,您可能会收到 401 错误。在返回请求之前,您必须将具有产品访问权限的 API 令牌添加到请求中。 |
|
404 |
未找到错误404。如果服务数据库中不存在请求参数( lat、等)的数据,您可能会收到 404 错误lon。date您不得重试同一请求。 |
|
429 |
错误 429 - 请求过多。如果超出了向此 API 提供的 API 请求的关键配额,您可能会收到 429 错误。您可以在一段时间后或延长密钥配额后重试请求。 |
|
5xx |
错误 5xx - 意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 API 请求示例附在您的电子邮件中,以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。 |
请求参数{
"lat": null,
"lon": null,
"dt": null,
"appid": null,
"units": null,
"lang": null
}
返回参数
{
"lat": null,
"lon": null,
"timezone": null,
"timezone_offset": null,
"data": null,
"data.dt": null,
"data.sunrise": null,
"data.sunset": null,
"data.temp": null,
"data.feels_like": null,
"data.pressure": null,
"data.humidity": null,
"data.dew_point": null,
"data.clouds": null,
"data.uvi": null,
"data.visibility": null,
"data.wind_speed": null,
"data.wind_gust": null,
"data.wind_deg": null,
"data.weather": null,
"data.weather.id": null,
"data.weather.main": null,
"data.weather.description": null,
"data.weather.icon": null,
"data.rain": null,
"data.snow": null,
"cod": "",
"message": "",
"parameters": ""
}
错误码
{
"400": "错误 400 - 错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 400 错误。所有缺失或不正确的参数名称列表将在“ErrorResponse”对象的“parameters”属性中返回。",
"401": "错误 401 - 未经授权。如果请求中未提供 API 令牌,或者请求中提供的 API 令牌未授予对此 API 的访问权限,您可能会收到 401 错误。在返回请求之前,您必须将具有产品访问权限的 API 令牌添加到请求中。",
"404": "未找到错误404。如果服务数据库中不存在请求参数( lat、等)的数据,您可能会收到 404 错误lon。date您不得重试同一请求。",
"429": "错误 429 - 请求过多。如果超出了向此 API 提供的 API 请求的关键配额,您可能会收到 429 错误。您可以在一段时间后或延长密钥配额后重试请求。",
"5xx": "错误 5xx - 意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 API 请求示例附在您的电子邮件中,以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。"
}
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
---|---|---|---|---|
lat |
String |
是 |
纬度,十进制(-90;90) |
|
lon |
String |
是 |
经度,十进制(-180;180) |
|
date |
String |
是 |
请求数据的日期采用“YYYY-MM-DD”格式。日期可用于 |
|
appid |
String |
是 |
您唯一的 |
|
units |
String |
否 |
测量单位。standard,metric并且imperial |
|
lang |
String |
否 |
语言 |
参数名 |
参数类型 |
默认值 |
描述 |
---|---|---|---|
lat |
String |
位置的纬度,十进制 |
|
lon |
String |
位置经度,十进制(-180;180) |
|
tz |
String |
±XX:XX |
|
date |
String |
API |
|
units |
String |
请求中指定的测量单位。了解更多 |
|
cloud_cover |
String |
云相关信息 |
|
afternoon |
String |
请求中指定日期 |
|
humidity |
String |
湿度相关信息 |
|
afternoon |
String |
请求中指定日期 |
|
precipitation |
String |
降水相关信息 |
|
total |
String |
请求中指定日期的相当于降水量的液态水总量 |
|
pressure |
String |
大气压相关信息 |
|
afternoon |
String |
请求中指定日期 |
|
temperature |
String |
温度相关信息 |
|
min |
String |
请求中指定日期的最低温度 |
|
max |
String |
请求中指定日期的最高温度 |
|
afternoon |
String |
请求中指定日期 |
|
night |
String |
请求中指定日期 |
|
evening |
String |
请求中指定日期 |
|
morning |
String |
请求中指定日期的 |
|
wind |
String |
风速相关信息 |
|
max |
String |
最大风速相关信息 |
|
speed |
String |
请求中指定日期的最大风速 |
|
direction |
String |
与最大风速相关的风向,度数(气象) |
|
cod |
String |
错误代码 |
|
message |
String |
错误描述 |
|
parameters |
String |
(可选)与此特定错误相关的请求参数名称列表 |
错误码 |
错误信息 |
描述 |
---|---|---|
400 |
错误400-错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到 |
|
401 |
错误401-未经授权。如果请求中未提供 |
|
404 |
未找到错误404。如果服务数据库中不存在请求参数( |
|
429 |
错误429-请求过多。如果超出了向此 |
|
5xx |
错误5xx-意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的 |
请求参数{
"lat": "",
"lon": "",
"date": "",
"appid": "",
"units": "",
"lang": ""
}
返回参数
{
"lat": "",
"lon": "",
"tz": "",
"date": "",
"units": "",
"cloud_cover": "",
"afternoon": "",
"humidity": "",
"precipitation": "",
"total": "",
"pressure": "",
"temperature": "",
"min": "",
"max": "",
"night": "",
"evening": "",
"morning": "",
"wind": "",
"speed": "",
"direction": "",
"cod": "",
"message": "",
"parameters": ""
}
错误码
{
"400": "错误400-错误请求。如果请求中缺少某些必需参数,或者某些请求参数的格式不正确或值超出允许的范围,您可能会收到",
"401": "错误401-未经授权。如果请求中未提供",
"404": "未找到错误404。如果服务数据库中不存在请求参数(",
"429": "错误429-请求过多。如果超出了向此",
"5xx": "错误5xx-意外错误。如果出现其他内部错误,您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们,并将收到此错误的"
}
使用步骤
1. 注册 OpenWeather 服务:如果您尚未获得 OpenWeather API 密钥,请注册 OpenWeather 服务。您可以访问 OpenWeather 网站注册并获取 API 密钥。同时,查看定价页面以了解有关价格的详细信息。
2. 订阅 One Call API 3.0:One Call API 3.0 是一个单独的产品,您需要单独订阅。您只需根据对该产品进行的 API 调用次数付费。默认情况下,每天对该产品的 API 调用次数限制为 2000 次。如果您需要更改此限制,请转到个人帐户中的“计费计划”选项卡以更新设置。
3. 获取 API 密钥:在注册后,您将获得一个 API 密钥,您需要在 API 调用中使用该密钥以获取数据。确保在每次 API 调用中都添加您的 API 密钥。
4. 选择数据类型:根据您的需求选择所需的数据类型。您可以获取当前天气、预测天气数据、时间戳天气数据以及每日汇总天气数据。
5. 进行 API 调用:根据您所选的数据类型和相关技术文档,构建 API 调用。
根据文档中的指示,使用以下终端进行 API 调用:
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}
确保将 `{lat}` 和 `{lon}` 替换为您所需地理位置的纬度和经度,并将 `{API key}` 替换为您获得的 API 密钥。
6. 处理 API 响应:收到 API 响应后,您可以解析数据并根据您的应用需求进行处理和显示。
通过遵循以上步骤,您就可以开始使用 OpenWeather One Call API 3.0 来获取天气数据,并将其集成到您的应用程序中。
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标,或者反之亦然,请使用Geocoder 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
祖鲁语