天气预报服务-OpenWeather
专用API
服务商:
OpenWeather
【更新时间: 2024.03.20】
One Call API 3.0是一项功能强大且价格实惠的天气服务,可让您检索当前、历史、短期和长期预测的天气数据以及恶劣天气警报,使其成为各种用例的理想集成。
|
- API详情
- 接口文档
- 定价
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
什么是OpenWeather的天气预报服务?
什么是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
祖鲁语