天氣預報服務-OpenWeather

專用API

服務商： OpenWeather

【更新時間: 2024.03.20】 One Call API 3.0是一項功能強大且價格實惠的天氣服務，可讓您檢索當前、歷史、短期和長期預測的天氣數據以及惡劣天氣警報，使其成為各種用例的理想集成。

免費（1000次/天免費超出0.0015美元次）去服務商官網采購>

瀏覽次數

445

采購人數

試用次數

SLA: N/A

響應: N/A

適用于個人&企業

試用

選擇書簽:

完成

取消

書簽名稱

確定

相似API

天氣預報查詢-API Space

220

天氣預報查詢，可提供全國以及全球眾多城市的天氣詳細信息查詢服務。無論是國內還是國外的城市，都能準確獲取其天氣狀況，包括溫度、天氣類型、風力等，為您的出行、生活等提供可靠的天氣參考。

未來7天生活指數-API Space

105

未來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】天氣預警，能夠獲取指定城市當前正在生效的各類天氣預警信息，比如臺風、暴雨、暴雪、大風、高溫、雷電、大霧、寒潮等等。它可為相關決策和行動提供及時且關鍵的天氣預警數據支持，以便更好地應對各種天氣狀況。

生活服務 > 天氣環境

246

智能家居信息-中指云專用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

生活服務 > 天氣環境

246

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

公共數據 > 新房數據

配送服務-美團外賣專用API

電子商務 > 物流配送

History 專用API

生活服務 > 天氣環境

国内精品久久久久影院日本,日本中文字幕视频,99久久精品99999久久,又粗又大又黄又硬又爽毛片

天氣預報服務-OpenWeather

什么是OpenWeather的天氣預報服務?

服務詳情

核心功能

核心優勢

什么是OpenWeather的天氣預報服務接口？

使用步驟

使用注意事項

支持語言

我們的使命

OpenWeather 社會倡議

教育

衛生保健

開源

氣象站

我們的價值觀

熱情

智力

責任

使用步驟

使用注意事項

支持語言

我們的使命

OpenWeather 社會倡議

教育

衛生保健

開源

氣象站

我們的價值觀

熱情

智力

責任

我們的合作伙伴

英國皇家氣象學會

Achilles 認證供應商

采購平臺

API平臺

API平臺

API學院

公司