获取分钟级预报（实验性功能）

forecast:minutes 端点可针对指定位置提供高分辨率的逐分钟降水预报（也称为临近预报）。

该 API 会返回 6 小时时间范围内的以下信息：

  • 预测时间段的开始时间和结束时间
  • 所请求位置的时区
  • 每个预测区段的开始时间和结束时间
  • 每个时间段的降水预测类型、可能性、降水量和强度

条款

这些条款是根据《Google Maps Platform 服务专用条款》第 6 条（正式发布前产品条款）发布的，并已获得 Google 和您的同意。

1.1 提供方说明要求。如果客户使用 Weather API 中的 Google 地图内容，则必须按照文档的规定向 Google 提供提供方信息。

1.2 限制。客户不得使用从 Weather API 检索到的 Google 地图内容来重新创建 Google 服务或产品（例如，不得在天气应用或天气模型中使用从 Weather API 检索到的数据，因为这些应用或模型的主要目的是提供天气信息）。

1.3 缓存。客户可以在适用的缓存期限内，暂时缓存 Weather API 中的适用 Google 地图内容，如表 1.3.1（缓存权限）中所述。

表 1.3.1（缓存权限）

这些权限是 Google Maps Platform 服务专用条款表 17.2.1 中所述权限的补充。

Google 地图内容 缓存周期
分钟级天气预报值 一小时，之后客户必须删除缓存的 Google 地图内容

关于分钟级预测请求

如需请求分钟级天气预报，请向以下网址发送 HTTP GET 请求：

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

在请求参数中添加相应位置的纬度和经度坐标。

请求参数

forecast.minutes 端点接受以下请求参数：

参数 说明 必填或可选
location.latitude 所请求位置的纬度坐标。 必需
location.longitude 所请求位置的经度坐标。 必需
unitsSystem 所请求的单位制。此属性的值包括：
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

如果未指定单位制，则响应默认为 METRIC。

 可选
pageSize 指定要返回的结果数上限。 可选
pageToken 从上一个请求收到的页面令牌。如需检索下一页数据，请在下一个请求中传递 pageToken 作为输入参数。 可选

分钟级天气预报响应简介

Weather API 会在响应正文中返回以下字段：

字段 说明
overallPredictionTimeframe 预测的总体时间范围。
overallPredictionTimeframe.startTime 预测时间范围的开始时间。这反映了初始参考点。
overallPredictionTimeframe.endTime 预测时间段的结束时间。此时间设置为开始时间后的 6 小时。
timeZone 所请求位置的时区。
segments 分钟级预测细分，以 timeFrame 表示。
segments.timeFrame 与细分相关的时段。
segments.timeFrame.startTime 细分的开始时间。
segments.timeFrame.endTime 片段的结束时间。
segments.type 相应时段内的预测降水类型。可取值包括：
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability 相应时段的预测降水概率。值以百分比表示，范围为 0 到 100。
segments.qpf 定量降水预报。
segments.qpf.quantity 相应时间段内的预测降水量。
segments.qpf.unit 用于衡量累积降水量的单位（例如 MILLIMETERS、INCHES）。
segments.snowfallAmount 相应时间段内的降雪量预测。
segments.snowfallAmount.quantity 相应时间段内的预计降雪量（以液态水当量表示）。
segments.snowfallAmount.unit 用于衡量积雪量的单位（例如 MILLIMETERS、INCHES）。
segments.intensity 相应路段的降水强度。可取值包括：
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken 可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

分钟级预测示例

以下示例请求西弗吉尼亚州某个位置的分钟级天气预报信息：

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

在响应中，segments 对象表示整个预测时间范围的每个细分：

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}