OpenWeather One Call 3.0 · 天气与预报API

OpenWeather One Call 3.0按坐标返回当前天气、逐分钟/小时/日预报及可用预警，需API key和独立One Call订阅。文档列每日1000次免费调用，额外按量收费。仅文档整理，未查询；本文不把3.0与推荐的新4.0功能混用。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-8ca1eb139010c21628354699
Card version: 2
Updated: 2026-10-24T17:48:31.4500616+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

Explore the versatile OpenWeather One Call API 3.0. It includes features like current weather updates, future forecasts up to 1.5 years, and detailed historical weather data starting from 01-01-1979. Updated every 10 minutes, the API ensures accuracy and relevancy. It allows for 1,000 free daily API calls and a pay-as-you-go model for additional usage. Start using it now.

Inputs

lat(-90..90)、lon(-180..180)、appid必填；城市转坐标需另用Geocoding API，本项不执行。
exclude可用逗号分隔排除current、minutely、hourly、daily、alerts。
units可standard/metric/imperial，lang选择描述语言；详细其他端点参数不与此端点混用。

Outputs

JSON可含当前天气、1小时逐分钟、48小时逐小时、8日预报及国家预警；响应组件依查询和实际可用数据。
含timezone/offset与天气数值、UTC Unix时间等；预警可有发布机构、事件、开始结束、描述和tags。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "appid\u67E5\u8BE2\u53C2\u6570\u4F20\u8D26\u6237API key\uFF0C\u4E14key\u5FC5\u987B\u83B7One Call\u4EA7\u54C1\u6743\u9650\uFF1B\u6B64\u4EA7\u54C1\u9700\u8981\u72EC\u7ACB\u8BA2\u9605\u3002\u672C\u8F6E\u672A\u6CE8\u518C\u3001\u8BA2\u9605\u6216\u4F7F\u7528key\u3002"
  },
  "command": null,
  "entry_url": "https://api.openweathermap.org/data/3.0/onecall",
  "kind": "http_api",
  "method": "GET",
  "request_example": null,
  "requirements": [
    "\u6709\u6548OpenWeather\u8D26\u6237key\u53CAOne Call\u8BA2\u9605\uFF0C\u666E\u901Akey\u5B58\u5728\u4E0D\u4EE3\u8868\u6709\u8BE5\u4EA7\u54C1\u6743\u9650\u3002",
    "\u63D0\u4F9Blat/lon\u5750\u6807\uFF1B\u6309\u6240\u9700\u5355\u4F4D\u8BBE\u7F6Eunits\uFF0C\u9ED8\u8BA4standard\u6E29\u5EA6\u4E3AKelvin\u3002",
    "\u5F53\u524D\u8D44\u6599\u53EA\u4F5C3.0\uFF0C\u5B98\u65B9\u63A8\u8350\u65B0\u96C6\u62104.0\u4F46\u672C\u8F6E\u672A\u8BFB\u6216\u9A8C\u8BC14.0\u5B8C\u6574\u5951\u7EA6\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "free_tier",
  "notes": "\u5B98\u65B9\u9875\u660E\u786EOne Call\u72EC\u7ACB\u8BA2\u9605\u5305\u542B\u6BCF\u65E51000\u6B21\u514D\u8D39\u8C03\u7528\uFF0C\u5176\u4F59\u6309\u8BE5\u4EA7\u54C1\u8C03\u7528\u6570\u4ED8\u8D39\uFF1B\u5177\u4F53\u5355\u4EF7\u3001\u4ED8\u6B3E\u65B9\u5F0F\u548C\u8D26\u5355\u9650\u5236\u672C\u9875\u672A\u6838\uFF0C\u672A\u8BA2\u9605\u6216\u89E6\u53D1\u8D39\u7528\u3002",
  "source_url": "https://openweathermap.org/api/one-call-3"
}

{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8C03\u7528\u53D1\u9001API key\u53CA\u5730\u70B9\u5750\u6807\uFF0C\u53EF\u80FD\u66B4\u9732\u67E5\u8BE2\u4F4D\u7F6E\uFF1B\u65E5\u5FD7\u3001\u4FDD\u7559\u3001\u518D\u5206\u53D1\u8BB8\u53EF\u548C\u9690\u79C1\u6761\u6B3E\u672A\u6838\u3002\u672C\u8F6E\u672A\u67E5\u5929\u6C14\u3001\u4E0A\u4F20\u4F4D\u7F6E\u6216\u8C03\u7528\u9875\u5185AI Weather Assistant\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

独立订阅的1000免费调用/日不等于所有OpenWeather产品免费，也不保证超额自动停。
默认standard温度是Kelvin，metric为Celsius、imperial为Fahrenheit；降雨等字段的单位需逐项核对。
部分字段只有实际测量/计算且现象存在才出现，极区可无日出日落；不能把缺失预警当安全保证。
3.0页面推荐4.0用于新集成，当前不承诺新功能、长期兼容或预测准确性。

Unknowns

认证成功、已订阅产品、实际额度/单价和超额控制未知。
地点覆盖、观测时效、预警完整性及预测准确性未验证。
未运行天气、历史数据、AI建议或其他付费API。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:47:37.0161837\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://openweathermap.org/api/one-call-3"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u8C03\u7528\u53D1\u9001API key\u53CA\u5730\u70B9\u5750\u6807\uFF0C\u53EF\u80FD\u66B4\u9732\u67E5\u8BE2\u4F4D\u7F6E\uFF1B\u65E5\u5FD7\u3001\u4FDD\u7559\u3001\u518D\u5206\u53D1\u8BB8\u53EF\u548C\u9690\u79C1\u6761\u6B3E\u672A\u6838\u3002\u672C\u8F6E\u672A\u67E5\u5929\u6C14\u3001\u4E0A\u4F20\u4F4D\u7F6E\u6216\u8C03\u7528\u9875\u5185AI Weather Assistant\u3002"
  },
  "description": "Explore the versatile OpenWeather One Call API 3.0. It includes features like current weather updates, future forecasts up to 1.5 years, and detailed historical weather data starting from 01-01-1979. Updated every 10 minutes, the API ensures accuracy and relevancy. It allows for 1,000 free daily API calls and a pay-as-you-go model for additional usage. Start using it now.",
  "inputs": [
    "lat(-90..90)\u3001lon(-180..180)\u3001appid\u5FC5\u586B\uFF1B\u57CE\u5E02\u8F6C\u5750\u6807\u9700\u53E6\u7528Geocoding API\uFF0C\u672C\u9879\u4E0D\u6267\u884C\u3002",
    "exclude\u53EF\u7528\u9017\u53F7\u5206\u9694\u6392\u9664current\u3001minutely\u3001hourly\u3001daily\u3001alerts\u3002",
    "units\u53EFstandard/metric/imperial\uFF0Clang\u9009\u62E9\u63CF\u8FF0\u8BED\u8A00\uFF1B\u8BE6\u7EC6\u5176\u4ED6\u7AEF\u70B9\u53C2\u6570\u4E0D\u4E0E\u6B64\u7AEF\u70B9\u6DF7\u7528\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "appid\u67E5\u8BE2\u53C2\u6570\u4F20\u8D26\u6237API key\uFF0C\u4E14key\u5FC5\u987B\u83B7One Call\u4EA7\u54C1\u6743\u9650\uFF1B\u6B64\u4EA7\u54C1\u9700\u8981\u72EC\u7ACB\u8BA2\u9605\u3002\u672C\u8F6E\u672A\u6CE8\u518C\u3001\u8BA2\u9605\u6216\u4F7F\u7528key\u3002"
    },
    "command": null,
    "entry_url": "https://api.openweathermap.org/data/3.0/onecall",
    "kind": "http_api",
    "method": "GET",
    "request_example": null,
    "requirements": [
      "\u6709\u6548OpenWeather\u8D26\u6237key\u53CAOne Call\u8BA2\u9605\uFF0C\u666E\u901Akey\u5B58\u5728\u4E0D\u4EE3\u8868\u6709\u8BE5\u4EA7\u54C1\u6743\u9650\u3002",
      "\u63D0\u4F9Blat/lon\u5750\u6807\uFF1B\u6309\u6240\u9700\u5355\u4F4D\u8BBE\u7F6Eunits\uFF0C\u9ED8\u8BA4standard\u6E29\u5EA6\u4E3AKelvin\u3002",
      "\u5F53\u524D\u8D44\u6599\u53EA\u4F5C3.0\uFF0C\u5B98\u65B9\u63A8\u8350\u65B0\u96C6\u62104.0\u4F46\u672C\u8F6E\u672A\u8BFB\u6216\u9A8C\u8BC14.0\u5B8C\u6574\u5951\u7EA6\u3002"
    ]
  },
  "limitations": [
    "\u72EC\u7ACB\u8BA2\u9605\u76841000\u514D\u8D39\u8C03\u7528/\u65E5\u4E0D\u7B49\u4E8E\u6240\u6709OpenWeather\u4EA7\u54C1\u514D\u8D39\uFF0C\u4E5F\u4E0D\u4FDD\u8BC1\u8D85\u989D\u81EA\u52A8\u505C\u3002",
    "\u9ED8\u8BA4standard\u6E29\u5EA6\u662FKelvin\uFF0Cmetric\u4E3ACelsius\u3001imperial\u4E3AFahrenheit\uFF1B\u964D\u96E8\u7B49\u5B57\u6BB5\u7684\u5355\u4F4D\u9700\u9010\u9879\u6838\u5BF9\u3002",
    "\u90E8\u5206\u5B57\u6BB5\u53EA\u6709\u5B9E\u9645\u6D4B\u91CF/\u8BA1\u7B97\u4E14\u73B0\u8C61\u5B58\u5728\u624D\u51FA\u73B0\uFF0C\u6781\u533A\u53EF\u65E0\u65E5\u51FA\u65E5\u843D\uFF1B\u4E0D\u80FD\u628A\u7F3A\u5931\u9884\u8B66\u5F53\u5B89\u5168\u4FDD\u8BC1\u3002",
    "3.0\u9875\u9762\u63A8\u83504.0\u7528\u4E8E\u65B0\u96C6\u6210\uFF0C\u5F53\u524D\u4E0D\u627F\u8BFA\u65B0\u529F\u80FD\u3001\u957F\u671F\u517C\u5BB9\u6216\u9884\u6D4B\u51C6\u786E\u6027\u3002"
  ],
  "outputs": [
    "JSON\u53EF\u542B\u5F53\u524D\u5929\u6C14\u30011\u5C0F\u65F6\u9010\u5206\u949F\u300148\u5C0F\u65F6\u9010\u5C0F\u65F6\u30018\u65E5\u9884\u62A5\u53CA\u56FD\u5BB6\u9884\u8B66\uFF1B\u54CD\u5E94\u7EC4\u4EF6\u4F9D\u67E5\u8BE2\u548C\u5B9E\u9645\u53EF\u7528\u6570\u636E\u3002",
    "\u542Btimezone/offset\u4E0E\u5929\u6C14\u6570\u503C\u3001UTC Unix\u65F6\u95F4\u7B49\uFF1B\u9884\u8B66\u53EF\u6709\u53D1\u5E03\u673A\u6784\u3001\u4E8B\u4EF6\u3001\u5F00\u59CB\u7ED3\u675F\u3001\u63CF\u8FF0\u548Ctags\u3002"
  ],
  "pricing": {
    "model": "free_tier",
    "notes": "\u5B98\u65B9\u9875\u660E\u786EOne Call\u72EC\u7ACB\u8BA2\u9605\u5305\u542B\u6BCF\u65E51000\u6B21\u514D\u8D39\u8C03\u7528\uFF0C\u5176\u4F59\u6309\u8BE5\u4EA7\u54C1\u8C03\u7528\u6570\u4ED8\u8D39\uFF1B\u5177\u4F53\u5355\u4EF7\u3001\u4ED8\u6B3E\u65B9\u5F0F\u548C\u8D26\u5355\u9650\u5236\u672C\u9875\u672A\u6838\uFF0C\u672A\u8BA2\u9605\u6216\u89E6\u53D1\u8D39\u7528\u3002",
    "source_url": "https://openweathermap.org/api/one-call-3"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:47:37.0161837\u002B00:00",
      "title": "One Call API 3.0",
      "url": "https://openweathermap.org/api/one-call-3"
    }
  ],
  "summary": "OpenWeather One Call 3.0\u6309\u5750\u6807\u8FD4\u56DE\u5F53\u524D\u5929\u6C14\u3001\u9010\u5206\u949F/\u5C0F\u65F6/\u65E5\u9884\u62A5\u53CA\u53EF\u7528\u9884\u8B66\uFF0C\u9700API key\u548C\u72EC\u7ACBOne Call\u8BA2\u9605\u3002\u6587\u6863\u5217\u6BCF\u65E51000\u6B21\u514D\u8D39\u8C03\u7528\uFF0C\u989D\u5916\u6309\u91CF\u6536\u8D39\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u67E5\u8BE2\uFF1B\u672C\u6587\u4E0D\u628A3.0\u4E0E\u63A8\u8350\u7684\u65B04.0\u529F\u80FD\u6DF7\u7528\u3002",
  "tags": [
    "OpenWeather",
    "One Call 3.0",
    "\u5929\u6C14",
    "\u9884\u62A5",
    "HTTP API",
    "API key",
    "\u72EC\u7ACB\u8BA2\u9605"
  ],
  "terms_url": null,
  "title": "OpenWeather One Call 3.0 \u00B7 \u5929\u6C14\u4E0E\u9884\u62A5API",
  "unknowns": [
    "\u8BA4\u8BC1\u6210\u529F\u3001\u5DF2\u8BA2\u9605\u4EA7\u54C1\u3001\u5B9E\u9645\u989D\u5EA6/\u5355\u4EF7\u548C\u8D85\u989D\u63A7\u5236\u672A\u77E5\u3002",
    "\u5730\u70B9\u8986\u76D6\u3001\u89C2\u6D4B\u65F6\u6548\u3001\u9884\u8B66\u5B8C\u6574\u6027\u53CA\u9884\u6D4B\u51C6\u786E\u6027\u672A\u9A8C\u8BC1\u3002",
    "\u672A\u8FD0\u884C\u5929\u6C14\u3001\u5386\u53F2\u6570\u636E\u3001AI\u5EFA\u8BAE\u6216\u5176\u4ED6\u4ED8\u8D39API\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:47:37.0161837\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://openweathermap.org/api/one-call-3"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-8ca1eb139010c21628354699",
  "version": 2,
  "source_url": "https://openweathermap.org/api/one-call-3",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://openweathermap.org/api/one-call-3",
    "final_url": "https://openweathermap.org/api/one-call-3",
    "status_code": 200,
    "title": "One Call API 3.0",
    "description": "Explore the versatile OpenWeather One Call API 3.0. It includes features like current weather updates, future forecasts up to 1.5 years, and detailed historical weather data starting from 01-01-1979. Updated every 10 minutes, the API ensures accuracy and relevancy. It allows for 1,000 free daily API calls and a pay-as-you-go model for additional usage. Start using it now.",
    "checked_at": "2026-10-24T17:47:37.0161837\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:47:41.1085519\u002B00:00",
  "updated_at": "2026-10-24T17:48:31.4500616\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-8ca1eb139010c21628354699?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-8ca1eb139010c21628354699?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u5929\u6C14\u6570\u636E\uFF5C\u72EC\u7ACB\u8BA2\u9605\u53CA\u5BC6\u94A5\u7684\u5929\u6C14\u9884\u62A5API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-f4f7375423eb77a4aadf34441241dccc",
        "source_url": "https://openweathermap.org/api/one-call-3",
        "content_sha256": "6e97960eba2eb8f5599187c5bc7dc3c6c9800a62a2d250261225b0372f4528af",
        "decoded_bytes": 965262,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:47:37.0161837\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "6e97960eba2eb8f5599187c5bc7dc3c6c9800a62a2d250261225b0372f4528af",
        "text_utf8_bytes": 965262,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-8ca1eb139010c21628354699/materials/material-f4f7375423eb77a4aadf34441241dccc?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-c3dc09b2c6b44371b43fa56c1653993a",
    "reason": "\u4F9D\u636E\u672C\u6279OpenWeather One Call 3.0\u5B98\u65B9\u6587\u6863\u6574\u7406\u5F53\u524D\u5929\u6C14/\u9884\u62A5\u7AEF\u70B9\u3001\u8BA2\u9605\u4E0E\u514D\u8D39\u8C03\u7528\u6570\uFF1B\u4E0D\u8C03\u7528\u5929\u6C14API\u6216AI\u52A9\u624B\u3002",
    "source_urls": [
      "https://openweathermap.org/api/one-call-3"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-8ca1eb139010c21628354699",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-8ca1eb139010c21628354699?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-8ca1eb139010c21628354699?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure