天气预报服务-OpenWeather

天气预报服务-OpenWeather

专用API
服务商 服务商： OpenWeather
【更新时间: 2024.03.20】 One Call API 3.0是一项功能强大且价格实惠的天气服务，可让您检索当前、历史、短期和长期预测的天气数据以及恶劣天气警报，使其成为各种用例的理想集成。
免费 （1000次/天免费超出0.0015美元次） 去服务商官网采购>
服务星级：
6星
⭐ ⭐ ⭐ ⭐ ⭐ ⭐ 🌟️
调用次数
0 次
集成人数
0 人
商用人数
0 人
! SLA: N/A
! 响应: N/A
! 适用于个人&企业
添加到书签
×
完成
取消
×
书签名称
确定
<
产品介绍
>

什么是天气预报服务-OpenWeather?

服务详情

我们的产品旨在提供简便、全面的天气数据服务，以满足用户对准确、及时天气信息的需求。通过结合 OpenWeather One Call API 3.0 的强大功能，我们为用户提供了一种无缝迁移从 Dark Sky API 的解决方案，并且更进一步地提供了更丰富的功能和数据。

核心功能

  • 当前和预报的天气数据查询服务
  • 时间戳天气数据查询服务
  • 每日汇总数据查询服务

核心优势

  • 全面的数据覆盖：通过 One Call API 3.0，用户可以轻松地获取当前天气情况、短期和长期预报，以及政府天气警报等重要信息。不仅如此，我们还提供了过去40多年历史存档的天气数据，以及未来1.5年的预测，满足用户对历史数据和长期趋势的需求。

  • 高频更新：我们的 API 每10分钟更新一次，以确保用户获得最准确、最新的天气数据。这种高频率的更新确保了用户可以及时获取到最近的天气变化，做出相应的决策。

  • 简单易用：我们的产品设计注重简洁易用，用户可以轻松地通过 API 获取所需的数据，无需繁琐的配置或操作。API 的三个端点提供了不同层次和时间范围的数据，满足不同用户的需求。

什么是天气预报服务-OpenWeather接口？

由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用天气预报服务-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祖鲁语
<
产品问答
>
?
接口请求频率？
One Call API 3.0 基于专有的OpenWeather 模型，每 10 分钟更新一次。因此，为了接收最准确和最新的天气数据，我们建议您每 10 分钟请求一次 One Call API 3.0。
?
One Call API 3.0 的订阅费用是多少？
通过订阅 One Call API 3.0，您只需为对该产品进行的 API 调用次数付费。每天免费调用 1​​,000 次 API。我们的系统会汇总超出免费限额（每天 1,000 个呼叫）的呼叫次数。系统会在订阅月份结束时自动向您收费。
<
关于我们
>
OpenWeather
企业
OpenWeather是一个由IT专家和数据科学家组成的团队，一直在实践深度天气数据科学。对于地球上的每一个点，OpenWeather通过光速api提供历史、当前和预测的天气数据。总部设在GB伦敦。
联系信息
服务时间： 0:00:00至24:00:00
邮箱： info@openweathermap.org
API接口列表
当前和预报的天气数据
时间戳天气数据
每日汇总
当前和预报的天气数据
1.1 简要描述
要获取当前天气、1 小时的分钟预报、48 小时的每小时预报、8 天的每日预报以及政府天气警报，请使用文档的此部分。 如果您对 1979 年 1 月 1 日至未来 4 天的任何时间戳的天气数据感兴趣，请阅读“时间戳的天气数据”部分。 如果您对从 1979 年 1 月 2 日到未来 1.5 年的长期预报的每日汇总天气数据感兴趣，请阅读文档的“每日汇总”部分。
1.2 请求URL
https://api.openweathermap.org/data/3.0/onecall
1.3 请求方式
POST
1.4 入参
参数名 参数类型 默认值 是否必传 描述
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参数来获取您的语言的输出。
1.5 出参
参数名 参数类型 默认值 描述
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 （可选）与此特定错误相关的请求参数名称列表 错误列表
1.6 错误码
错误码 错误信息 描述
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 请求示例附在您的电子邮件中，以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。
1.7 示例 
请求参数{
    "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 请求示例附在您的电子邮件中，以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。"
}
时间戳天气数据
2.1 简要描述
要了解如何获取从 1979 年 1 月 1 日到提前 4 天预报的任何时间戳的天气数据，请使用文档的这一部分。 如果您对当前天气数据、预报和天气警报感兴趣，请阅读“当前和预报天气数据”部分。 如果您对从 1979 年 1 月 2 日到未来 1.5 年的长期预报的每日汇总天气数据感兴趣，请阅读文档的“每日汇总”部分。
2.2 请求URL
https://api.openweathermap.org/data/3.0/onecall/timemachine
2.3 请求方式
POST
2.4 入参
参数名 参数类型 默认值 是否必传 描述
lat 是 纬度，十进制
lon 是 经度，十进制（-180；180）。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之，请使用我们的地理编码
dt 是 时间戳（Unix时间，UTC时区），例如dt=1586468027。数据提供时间为
appid 是 您唯一的
units 否 测量单位。standard，metric并且imperial
lang 否 您可以使用该lang参数来获取您的语言的输出。
2.5 出参
参数名 参数类型 默认值 描述
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 （可选）与此特定错误相关的请求参数名称列表
2.6 错误码
错误码 错误信息 描述
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 请求示例附在您的电子邮件中，以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。
2.7 示例 
请求参数{
    "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 请求示例附在您的电子邮件中，以便我们分析并及时为您找到解决方案。您可以重试导致此错误的请求。"
}
每日汇总
3.1 简要描述
要了解如何获取从 1979 年 1 月 2 日到未来 1.5 年长期预测的特定日期的汇总天气数据，请使用文档的此部分。 如果您对当前天气数据、预报和天气警报感兴趣，请阅读“当前和预报天气数据”部分。 如果您对 1979 年 1 月 1 日至未来 4 天的任何时间戳的天气数据感兴趣，请阅读“时间戳的天气数据”部分。
3.2 请求URL
https://api.openweathermap.org/data/3.0/onecall/day_summary
3.3 请求方式
POST
3.4 入参
参数名 参数类型 默认值 是否必传 描述
lat String 是 纬度，十进制（-90；90）
lon String 是 经度，十进制（-180；180）
date String 是 请求数据的日期采用“YYYY-MM-DD”格式。日期可用于
appid String 是 您唯一的
units String 否 测量单位。standard，metric并且imperial
lang String 否 语言
3.5 出参
参数名 参数类型 默认值 描述
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 （可选）与此特定错误相关的请求参数名称列表
3.6 错误码
错误码 错误信息 描述
400 错误400-错误请求。如果请求中缺少某些必需参数，或者某些请求参数的格式不正确或值超出允许的范围，您可能会收到
401 错误401-未经授权。如果请求中未提供
404 未找到错误404。如果服务数据库中不存在请求参数（
429 错误429-请求过多。如果超出了向此
5xx 错误5xx-意外错误。如果出现其他内部错误，您可能会收到“5xx”错误。错误响应代码将为“5xx”。请联系我们，并将收到此错误的
3.7 示例 
请求参数{
    "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祖鲁语
<
依赖服务
>
<
产品问答
>
?
接口请求频率？
One Call API 3.0 基于专有的OpenWeather 模型，每 10 分钟更新一次。因此，为了接收最准确和最新的天气数据，我们建议您每 10 分钟请求一次 One Call API 3.0。
?
One Call API 3.0 的订阅费用是多少？
通过订阅 One Call API 3.0，您只需为对该产品进行的 API 调用次数付费。每天免费调用 1​​,000 次 API。我们的系统会汇总超出免费限额（每天 1,000 个呼叫）的呼叫次数。系统会在订阅月份结束时自动向您收费。
<
关于我们
>
OpenWeather
企业
OpenWeather是一个由IT专家和数据科学家组成的团队，一直在实践深度天气数据科学。对于地球上的每一个点，OpenWeather通过光速api提供历史、当前和预测的天气数据。总部设在GB伦敦。
联系信息
服务时间： 0:00:00至24:00:00
邮箱： info@openweathermap.org