天气预报服务-OpenWeather

专用API

服务商： OpenWeather

【更新时间: 2024.03.20】 One Call API 3.0是一项功能强大且价格实惠的天气服务，可让您检索当前、历史、短期和长期预测的天气数据以及恶劣天气警报，使其成为各种用例的理想集成。

免费（1000次/天免费超出0.0015美元次）去服务商官网采购>

服务星级：6星

浏览次数

165

采购人数

试用次数

SLA: N/A

响应: N/A

适用于个人&企业

官方 Demo

书签名称

确定

相似API

天气预报查询-API Space

105

天气预报查询，可提供全国以及全球众多城市的天气详细信息查询服务。无论是国内还是国外的城市，都能准确获取其天气状况，包括温度、天气类型、风力等，为您的出行、生活等提供可靠的天气参考。

未来7天生活指数-API Space

未来7天生活指数可获取指定城市未来7天共计22种天气生活指数，包括晨练、洗车、穿衣、感冒、运动、旅游、舒适度、紫外线、钓鱼、晾晒、过敏、啤酒等12项指数。

History

History 可为用户提供全球任意地点的历史天气数据。无论是世界哪个角落，都能准确获取其过去的天气状况，这为气象研究、出行规划、农业生产等众多领域提供了有力的数据支持，助您更好地了解和应对不同环境。

API详情
接口文档
定价
使用指南
常见 FAQ
关于我们
相关推荐

产品介绍

什么是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专家和数据科学家团队组成，专注于深度气象数据科学。该公司为全球每个地点提供历史、当前和预测的气象数据，通过快速的API接口实现数据访问。OpenWeather的技术包括“时间机器”，能够提供长达45年的气象数据。此外，公司还提供基于AI和卫星图像的农业分析服务，以及天气地图和仪表板等产品。OpenWeather致力于通过技术创新，为用户提供准确、高质量的气象信息服务。

联系信息

服务时间： 0:00:00至24:00:00

邮箱： info@openweathermap.org

OpenWeather 总部位于英国伦敦，自 2014 年以来一直提供气象数据服务。我们的团队由经验丰富、充满热情且聪明的个人组成，在现代气象学、软件开发和企业集成项目方面拥有能力和丰富的经验。

OpenWeather 的商业运作与我们支持的非营利慈善活动齐头并进。我们通过积极支持此类项目来促进全球天气数据的可访问性和 FOSS 理念。无论是教育项目、学生开发第一个天气应用程序还是研究人员从事有前途的研究，我们都与用户社区密切合作。

我们的使命

当我们走向未来时，我们希望它保持清晰和绿色。

作为一家在现代气象学和软件开发领域拥有强大实力和丰富经验的科技公司，我们有责任利用我们的数据为可持续的产品和服务做出贡献。

我们致力于方便获取天气数据并激发人们对数据科学和气候学的兴趣。

我们的使命是利用 OpenWeather 准确、精确的天气数据帮助公司满怀信心地面对未来的趋势和挑战。

我们对可持续发展的承诺集中在提供直接访问天气数据、促进对数据科学和气候学的更深入了解。我们强调技术的绿色、道德方面，确保我们处理数据的方法保持清晰、开放和对环境负责。通过保持数据开放和可访问，我们使公司能够应对环境挑战，同时继续致力于绿色实践。

OpenWeather 社会倡议

教育

我们创建了一个将各种好点子聚集在一起的中心！来自世界各地的学生和教育工作者可以免费获得 6 个月的 OpenWeather 产品包数据访问权限，用于他们的研究项目。访问气候数据的人越多，其潜力就越大。

卫生保健

COVID-19 揭示了我们社会持续面临的医疗风险。我们希望继续支持应对当前医疗挑战的独立研究小组。我们至少可以免费访问我们的历史天气收集中期计划，其中包括在模拟 COVID-19 行为时要考虑的大气参数。

开源

世界各地的开发人员都受益于开源软件生态系统，OpenWeather 也不例外。虽然受到 Wikipedia 和 OpenStreetMap 等平台的影响，但我们在平台的基础中使用了开源软件。为了激励开源开发人员并促进天气数据的可访问性，我们选择为开源基础设施做出贡献的人提供装备。

气象站

加入我们吧！如果您也相信气候数据在应对气候和医疗保健挑战方面的重要性，并愿意为我们的计划做出贡献，那么我们邀请您将您的自动气象站连接到我们的平台。天气数据的准确性得益于来自世界各地的爱好者，我们通过我们的启动计划免费奖励这些贡献。

我们的价值观

在我们公司，我们遵循三大核心价值观：激情、智慧和责任。这些价值观塑造了我们的文化，指导我们的决策，并帮助我们实现目标。

热情

我们对自己的工作充满热情。我们相信，热情是推动创造力、创新和卓越的动力。我们致力于创造一个每个人都可以追求自己热情的环境，我们对工作的集体热情激励我们取得伟大的成就。

智力

我们相信智慧的力量。我们聘用有才华的人，并为他们提供成功所需的工具、资源和支持。我们重视各种形式的智慧，从书本知识到街头智慧，我们鼓励团队成员不断学习和成长。

责任

我们对我们的工作和成果负责。我们相信，我们有责任为我们的客户、团队成员和社区提供高质量的工作并取得卓越的成果。我们对自己的行为负责，并努力在所做的每一件事上产生积极的影响。

最可能同场景使用的其他API

BMI标准体重-天行数据专用API

【更新时间：2024.03.20】通过国际权威的标准体重指数（BMI）计算身材是否标准以及健康风险，成年人正常标准体重指数为18.5－23.9。

生活服务 > 度量衡

天气预警-API Space 专用API

【更新时间：2024.03.20】天气预警，能够获取指定城市当前正在生效的各类天气预警信息，比如台风、暴雨、暴雪、大风、高温、雷电、大雾、寒潮等等。它可为相关决策和行动提供及时且关键的天气预警数据支持，以便更好地应对各种天气状况。

生活服务 > 天气环境

112

智能家居信息-中指云专用API

【更新时间：2024.03.20】智能家居信息，涵盖了丰富的内容，如智能门锁的详细信息、可视对讲的相关数据、智能开关的具体情况、安防系统的各项内容，还有智能系统配套量以及型号数据等，全方位满足对智能家居相关信息的查询需求。

公共数据 > 新房数据

配送服务-美团外卖专用API

【更新时间：2024.03.20】美团配送作为美团旗下的即时物流平台，具备极其强大的实时配送网络。其能够很好地满足商户的配送需要以及消费者的多样化需求，通过该配送服务，可实现高效便捷的物流配送相关操作，带来优质的服务体验。

电子商务 > 物流配送

History 专用API

【更新时间：2024.03.20】History 可为用户提供全球任意地点的历史天气数据。无论是世界哪个角落，都能准确获取其过去的天气状况，这为气象研究、出行规划、农业生产等众多领域提供了有力的数据支持，助您更好地了解和应对不同环境。

生活服务 > 天气环境

当前和预报的天气数据

时间戳天气数据

每日汇总

当前和预报的天气数据

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”。请联系我们，并将收到此错误的"
}

产品价格

使用指南

使用步骤

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 的订阅费用是多少？

关于我们

OpenWeather

企业

联系信息

服务时间： 0:00:00至24:00:00

邮箱： info@openweathermap.org

我们的使命

当我们走向未来时，我们希望它保持清晰和绿色。

作为一家在现代气象学和软件开发领域拥有强大实力和丰富经验的科技公司，我们有责任利用我们的数据为可持续的产品和服务做出贡献。

我们致力于方便获取天气数据并激发人们对数据科学和气候学的兴趣。

我们的使命是利用 OpenWeather 准确、精确的天气数据帮助公司满怀信心地面对未来的趋势和挑战。

OpenWeather 社会倡议

教育

卫生保健

开源

气象站

我们的价值观

在我们公司，我们遵循三大核心价值观：激情、智慧和责任。这些价值观塑造了我们的文化，指导我们的决策，并帮助我们实现目标。

热情

智力

责任

合作案例

我们的合作伙伴

英国皇家气象学会

OpenWeather 是皇家气象学会 (RMetS) 的成员之一。

英国皇家气象学会是一个专业学术团体，致力于天气和气候的发展、相关的科学进步和研究以及更广泛的天气相关主题。

Achilles 认证供应商

OpenWeather 是 Achilles 认证的供应商。该认证计划确定和评估一系列质量，并向那些承诺遵守运营效率、性能和环境标准的公司颁发证书。Achilles 认证目前是世界上最受欢迎的供应商相关计划之一。

采购平台

OpenWeather 还登上了多家全球采购平台，例如 SAP Ariba 和 Coupa。

最可能同场景使用的其他API

BMI标准体重-天行数据专用API

【更新时间：2024.03.20】通过国际权威的标准体重指数（BMI）计算身材是否标准以及健康风险，成年人正常标准体重指数为18.5－23.9。

生活服务 > 度量衡

天气预警-API Space 专用API

生活服务 > 天气环境

112

智能家居信息-中指云专用API

公共数据 > 新房数据

配送服务-美团外卖专用API

电子商务 > 物流配送

History 专用API

生活服务 > 天气环境

天气预报服务-OpenWeather

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

服务详情

核心功能

核心优势

什么是OpenWeather的天气预报服务？

使用步骤

使用注意事项

支持语言

我们的使命

OpenWeather 社会倡议

教育

卫生保健

开源

气象站

我们的价值观

热情

智力

责任

使用步骤

使用注意事项

支持语言

我们的使命

OpenWeather 社会倡议

教育

卫生保健

开源

气象站

我们的价值观

热情

智力

责任

我们的合作伙伴

英国皇家气象学会

Achilles 认证供应商

采购平台

API平台

API平台

API学院

公司