天气预报服务-OpenWeather
专用API
【更新时间: 2024.03.20】
One Call API 3.0是一项功能强大且价格实惠的天气服务，可让您检索当前、历史、短期和长期预测的天气数据以及恶劣天气警报，使其成为各种用例的理想集成。
|
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祖鲁语
OpenWeather 总部位于英国伦敦，自 2014 年以来一直提供气象数据服务。我们的团队由经验丰富、充满热情且聪明的个人组成，在现代气象学、软件开发和企业集成项目方面拥有能力和丰富的经验。
OpenWeather 的商业运作与我们支持的非营利慈善活动齐头并进。我们通过积极支持此类项目来促进全球天气数据的可访问性和 FOSS 理念。无论是教育项目、学生开发第一个天气应用程序还是研究人员从事有前途的研究，我们都与用户社区密切合作。
当我们走向未来时，我们希望它保持清晰和绿色。
作为一家在现代气象学和软件开发领域拥有强大实力和丰富经验的科技公司，我们有责任利用我们的数据为可持续的产品和服务做出贡献。
我们致力于方便获取天气数据并激发人们对数据科学和气候学的兴趣。
我们的使命是利用 OpenWeather 准确、精确的天气数据帮助公司满怀信心地面对未来的趋势和挑战。
我们对可持续发展的承诺集中在提供直接访问天气数据、促进对数据科学和气候学的更深入了解。我们强调技术的绿色、道德方面，确保我们处理数据的方法保持清晰、开放和对环境负责。通过保持数据开放和可访问，我们使公司能够应对环境挑战，同时继续致力于绿色实践。
教育我们创建了一个将各种好点子聚集在一起的中心！来自世界各地的学生和教育工作者可以免费获得 6 个月的 OpenWeather 产品包数据访问权限，用于他们的研究项目。访问气候数据的人越多，其潜力就越大。 |
卫生保健COVID-19 揭示了我们社会持续面临的医疗风险。我们希望继续支持应对当前医疗挑战的独立研究小组。我们至少可以免费访问我们的历史天气收集中期计划，其中包括在模拟 COVID-19 行为时要考虑的大气参数。 |
开源世界各地的开发人员都受益于开源软件生态系统，OpenWeather 也不例外。虽然受到 Wikipedia 和 OpenStreetMap 等平台的影响，但我们在平台的基础中使用了开源软件。为了激励开源开发人员并促进天气数据的可访问性，我们选择为开源基础设施做出贡献的人提供装备。 |
气象站加入我们吧！如果您也相信气候数据在应对气候和医疗保健挑战方面的重要性，并愿意为我们的计划做出贡献，那么我们邀请您将您的自动气象站连接到我们的平台。天气数据的准确性得益于来自世界各地的爱好者，我们通过我们的启动计划免费奖励这些贡献。 |
在我们公司，我们遵循三大核心价值观：激情、智慧和责任。这些价值观塑造了我们的文化，指导我们的决策，并帮助我们实现目标。
我们对自己的工作充满热情。我们相信，热情是推动创造力、创新和卓越的动力。我们致力于创造一个每个人都可以追求自己热情的环境，我们对工作的集体热情激励我们取得伟大的成就。
我们相信智慧的力量。我们聘用有才华的人，并为他们提供成功所需的工具、资源和支持。我们重视各种形式的智慧，从书本知识到街头智慧，我们鼓励团队成员不断学习和成长。
我们对我们的工作和成果负责。我们相信，我们有责任为我们的客户、团队成员和社区提供高质量的工作并取得卓越的成果。我们对自己的行为负责，并努力在所做的每一件事上产生积极的影响。
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| 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祖鲁语
OpenWeather 总部位于英国伦敦，自 2014 年以来一直提供气象数据服务。我们的团队由经验丰富、充满热情且聪明的个人组成，在现代气象学、软件开发和企业集成项目方面拥有能力和丰富的经验。
OpenWeather 的商业运作与我们支持的非营利慈善活动齐头并进。我们通过积极支持此类项目来促进全球天气数据的可访问性和 FOSS 理念。无论是教育项目、学生开发第一个天气应用程序还是研究人员从事有前途的研究，我们都与用户社区密切合作。
当我们走向未来时，我们希望它保持清晰和绿色。
作为一家在现代气象学和软件开发领域拥有强大实力和丰富经验的科技公司，我们有责任利用我们的数据为可持续的产品和服务做出贡献。
我们致力于方便获取天气数据并激发人们对数据科学和气候学的兴趣。
我们的使命是利用 OpenWeather 准确、精确的天气数据帮助公司满怀信心地面对未来的趋势和挑战。
我们对可持续发展的承诺集中在提供直接访问天气数据、促进对数据科学和气候学的更深入了解。我们强调技术的绿色、道德方面，确保我们处理数据的方法保持清晰、开放和对环境负责。通过保持数据开放和可访问，我们使公司能够应对环境挑战，同时继续致力于绿色实践。
教育我们创建了一个将各种好点子聚集在一起的中心！来自世界各地的学生和教育工作者可以免费获得 6 个月的 OpenWeather 产品包数据访问权限，用于他们的研究项目。访问气候数据的人越多，其潜力就越大。 |
卫生保健COVID-19 揭示了我们社会持续面临的医疗风险。我们希望继续支持应对当前医疗挑战的独立研究小组。我们至少可以免费访问我们的历史天气收集中期计划，其中包括在模拟 COVID-19 行为时要考虑的大气参数。 |
开源世界各地的开发人员都受益于开源软件生态系统，OpenWeather 也不例外。虽然受到 Wikipedia 和 OpenStreetMap 等平台的影响，但我们在平台的基础中使用了开源软件。为了激励开源开发人员并促进天气数据的可访问性，我们选择为开源基础设施做出贡献的人提供装备。 |
气象站加入我们吧！如果您也相信气候数据在应对气候和医疗保健挑战方面的重要性，并愿意为我们的计划做出贡献，那么我们邀请您将您的自动气象站连接到我们的平台。天气数据的准确性得益于来自世界各地的爱好者，我们通过我们的启动计划免费奖励这些贡献。 |
在我们公司，我们遵循三大核心价值观：激情、智慧和责任。这些价值观塑造了我们的文化，指导我们的决策，并帮助我们实现目标。
我们对自己的工作充满热情。我们相信，热情是推动创造力、创新和卓越的动力。我们致力于创造一个每个人都可以追求自己热情的环境，我们对工作的集体热情激励我们取得伟大的成就。
我们相信智慧的力量。我们聘用有才华的人，并为他们提供成功所需的工具、资源和支持。我们重视各种形式的智慧，从书本知识到街头智慧，我们鼓励团队成员不断学习和成长。
我们对我们的工作和成果负责。我们相信，我们有责任为我们的客户、团队成员和社区提供高质量的工作并取得卓越的成果。我们对自己的行为负责，并努力在所做的每一件事上产生积极的影响。
OpenWeather 是皇家气象学会 (RMetS) 的成员之一。
英国皇家气象学会是一个专业学术团体，致力于天气和气候的发展、相关的科学进步和研究以及更广泛的天气相关主题。
OpenWeather 是 Achilles 认证的供应商。该认证计划确定和评估一系列质量，并向那些承诺遵守运营效率、性能和环境标准的公司颁发证书。Achilles 认证目前是世界上最受欢迎的供应商相关计划之一。
OpenWeather 还登上了多家全球采购平台，例如 SAP Ariba 和 Coupa。
幂简集成是创新的API平台，一站搜索、试用、集成国内外API。
Copyright © 2024 All Rights Reserved 北京蜜堂有信科技有限公司
公司地址： 北京市朝阳区光华路和乔大厦C座1508
意见反馈：010-533324933,mtyy@miitang.com
