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

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

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

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

条款

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

1.1 署名要求。 如果客户使用天气 API 中的 Google 地图 内容，则必须按照文档中的规定向 Google 提供 署名。

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

1.3 缓存。 客户可以在适用的缓存期内临时缓存天气 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 作为输入参数传递。 可选

关于逐分钟预报响应

天气 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"
    },
    ...
  ]
}