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

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 地图内容 缓存期
分钟预测值 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 预测时间范围的结束时间。此时间设为开始时间之后的六小时。
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"
    },
    ...
  ]
}