美国NWS公开天气资料API：点位映射后取网格预报；文档声明免费，User-Agent必须，未调用。
调用方式 / profile：nws-weather-documentation · 组件版本：documentation-sha256:59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779 · 引用此版本与调用方式
已记录条件
- invocation_mode = api：支持。Supported within this profile and component version. 依据：nws-weather-documentation-e1, nws-weather-documentation-e3
- execution_location = remote：支持。Supported within this profile and component version. 依据：nws-weather-documentation-e1
- output_format = json：支持。Supported within this profile and component version. 依据：nws-weather-documentation-e2
- auth_required = false：未知（可能存在冲突或待复核）。文档只说明必需User-Agent及未来API key计划，本站未验证当前认证状态。 依据：
入口与前提
- 协议
- HTTPS GET
- 认证
- 文档要求标识应用的User-Agent，并称未来将由API key替代；当前运行认证状态未验证，不凭未来计划猜实际key部署
- 价格是否查明
- known
- 配额是否查明
- unknown
https://api.weather.gov/points/{latitude},{longitude}- 仅官方文档声明，配方proposed；本站未连接、注册、调用第三方工具或核验实际账户。
- 文档明确open data、免费使用且有合理限流；数值不公开，超限等待恢复，本站未测试限流。
- User-Agent是必要前提；未来key计划不当已部署事实，身份/运行可用性保留unknown。
- 网格和office映射偶有变化，应周期复核/points；沿海marine网格仅forecastGridData，不保证全球预报覆盖。
配方 nws-weather-documentation-recipe · 修订 1
所需调用能力：
- lookup_nws_point_forecast
运行前提：
- 仅官方文档声明，配方proposed；本站未连接、注册、调用第三方工具或核验实际账户。
- 文档明确open data、免费使用且有合理限流；数值不公开，超限等待恢复，本站未测试限流。
- User-Agent是必要前提；未来key计划不当已部署事实，身份/运行可用性保留unknown。
- 网格和office映射偶有变化，应周期复核/points；沿海marine网格仅forecastGridData，不保证全球预报覆盖。
使用步骤：
- 准备已获授权的最小输入，核对本profile的适用范围、认证与费用；不填私人信息或凭据到公开示例。
- 候选GET https://api.weather.gov/points/39.7456,-97.0892，提供应用User-Agent；后续只沿响应中forecast URL取所需最小资料。本次未发送任何天气请求。
- 未来获准调用后核对HTTP/MCP状态、返回结构与请求条件，保留缺项/限流/权限错误；本次没有执行此步骤。
- 输入约定
- NWS覆盖范围内latitude/longitude；带识别应用的User-Agent，按返回的properties.forecast等URL读取，不硬编码office/grid映射。
- 输出约定
- 点位资源含forecast、forecastHourly、forecastGridData入口；前两者文档述未来七天12h或小时预报。GeoJSON/JSON-LD按Accept及endpoint区分。
- 成功检查
- 未来核对坐标映射、实际输出MIME与预报时效；空值/限流/服务错误保留unknown，不作为气象安全保证。
- 失败与回退
- 条件不满足、认证/限流/结构错误即停止该调用并保留unknown；不切换付费服务、不猜工具名、不执行写操作。
适用证据
nws-weather-documentation-e1 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/public-discovery-batch-20261024-02/sources/nws-weather-documentation.txt:L80-L85
- 来源版本
- documentation-sha256:59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 内容摘要
- 59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 采集时间
- 2026-10-24T04:50:58.7230172+00:00
The National Weather Service (NWS) API allows developers access to critical forecasts, alerts, and observations, along with other weather data. The API was designed with a cache-friendly approach that expires content based upon the information life cycle. The API is based upon of JSON-LD to promote machine data discovery. The API is located at: https://api.weather.gov Operational issues should be reported to nco.ops@noaa.gov. General use questions can be asked on the API github site. Pricing All of the information presented via the API is intended to be open data, free to use for any purpose. As a public service of the United States Government, we do not charge any fees for the usage of this service, although there are reasonable rate limits in place to prevent abuse and help ensure that everyone has access. The rate limit is not public information, but allows a generous amount for typical use. If the rate limit is execeed a request will return with an error, and may be retried after the limit clears (typically within 5 seconds). Proxies are more likely to reach the limit, whereas requests directly from clients are not likely.
覆盖条件：invocation_mode=api; execution_location=remote
nws-weather-documentation-e2 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/public-discovery-batch-20261024-02/sources/nws-weather-documentation.txt:L92-L97
- 来源版本
- documentation-sha256:59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 内容摘要
- 59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 采集时间
- 2026-10-24T04:50:58.7230172+00:00
A User Agent is required to identify your application. This string can be anything, and the more unique to your application the less likely it will be affected by a security event. If you include contact information (website or email), we can contact you if your string is associated to a security event. This will be replaced with an API key in the future. User-Agent: (myweatherapp.com, contact@myweatherapp.com) Formats Endpoints typically have a GeoJSON default format, given the inclusion of geometry data. See the Specification tab for details on each endpoint. Below are common formats available by the API. GeoJSON: application/geo+json JSON-LD: application/ld+json
覆盖条件：output_format=json
nws-weather-documentation-e3 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/public-discovery-batch-20261024-02/sources/nws-weather-documentation.txt:L110-L120
- 来源版本
- documentation-sha256:59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 内容摘要
- 59a3c9a77b836916dc8d8a54c2d0c53663016333ca85eb9d6da9c4f91f5af779
- 采集时间
- 2026-10-24T04:50:58.7230172+00:00
How do I get the point forecast? Forecasts are created at each NWS Weather Forecast Office (WFO) on their own grid definition, at a resolution of about 2.5km x 2.5km. The API endpoint for the 12h forecast periods at a specific grid location is formatted as: https://api.weather.gov/gridpoints/{office}/{gridX},{gridY}/forecast For example: https://api.weather.gov/gridpoints/TOP/31,80/forecast To obtain the grid forecast for a point location, use the /points endpoint to retrieve the current grid forecast endpoint by coordinates: https://api.weather.gov/points/{latitude},{longitude} For example: https://api.weather.gov/points/39.7456,-97.0892 This will provide the grid forecast endpoints for three format options in these properties: forecast - forecast for 12h periods over the next seven days forecastHourly - forecast for hourly periods over the next seven days forecastGridData - raw forecast data over the next seven days
覆盖条件：invocation_mode=api
结构化配方尚未提供或不适用于本版本；旧用法文字保留，连接与执行结果未知。