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

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

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

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

条款

这些条款是根据 Google 与您达成的协议，依据《Google Maps Platform 服务专用条款》第 6 条（非正式版产品条款）发布的。

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 地图内容 缓存周期
分钟级天气预报值 1 小时，之后客户必须删除缓存的 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"
    },
    ...
  ]
}