Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Minutengenaue Vorhersage abrufen (Beta)

Der forecast:minutes-Endpunkt bietet hochauflösende, minutengenaue Niederschlagsvorhersagen (auch als Nowcasting bezeichnet) für einen bestimmten Ort.

Die API gibt die folgenden Informationen für einen Zeitraum von 6 Stunden zurück:

Start- und Endzeit des Vorhersagezeitraums
Die Zeitzone des angeforderten Orts
Start- und Endzeit jedes Prognosesegments
Die vorhergesagte Art, Wahrscheinlichkeit, Menge und Intensität des Niederschlags während der einzelnen Segmente

Nutzungsbedingungen

Diese Bedingungen werden gemäß Abschnitt 6 (Nutzungsbedingungen für Pre-GA-Angebote) der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform herausgegeben, die zwischen Google und Ihnen vereinbart wurden.

1.1 Anforderungen für Quellenangaben. Wenn der Kunde Google Maps-Inhalte aus der Weather API verwendet, muss er Google gemäß der Dokumentation als Quelle angeben.

1.2 Einschränkungen. Kunden dürfen Google Maps-Inhalte, die über die Weather API abgerufen werden, nicht verwenden, um einen Google-Dienst oder ein Google-Produkt nachzubilden (z.B. Daten aus der Weather API in einer Wetter-App oder einem Wettermodell verwenden, deren Hauptzweck darin besteht, Wetterinformationen bereitzustellen).

1.3 Caching. Kunden dürfen die entsprechenden Google Maps-Inhalte aus der Weather API für den entsprechenden Cache-Zeitraum vorübergehend im Cache speichern, wie in Tabelle 1.3.1 (Caching-Berechtigungen) beschrieben.

Tabelle 1.3.1 (Caching-Berechtigungen)

Diese Berechtigungen gelten zusätzlich zu den in Tabelle 17.2.1 der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform beschriebenen Berechtigungen.

Inhalte aus Google Maps	Caching-Zeitraum
Prognosewerte für die Minute	Eine Stunde, danach muss der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen

Anfragen für Minutenprognosen

Wenn Sie Prognosen für Minuten anfordern möchten, senden Sie eine HTTP-GET-Anfrage an:

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

Geben Sie die Koordinaten für Breiten- und Längengrad des Standorts in den Anfrageparametern an.

Anfrageparameter

Der Endpunkt forecast.minutes akzeptiert die folgenden Anfrageparameter:

Parameter	Beschreibung	Erforderlich oder optional
`location.latitude`	Die Breitengradkoordinaten des angeforderten Standorts.	Erforderlich
`location.longitude`	Die Längengradkoordinaten des angeforderten Standorts.	Erforderlich
`unitsSystem`	Das angeforderte Einheitensystem. Mögliche Werte: `UNITS_SYSTEM_UNSPECIFIED` `IMPERIAL` `METRIC` Wenn kein Einheitensystem angegeben ist, wird in der Antwort standardmäßig `METRIC` verwendet.	Optional
`pageSize`	Gibt die maximale Anzahl der zurückzugebenden Ergebnisse an.	Optional
`pageToken`	Ein Seitentoken, das von einer vorherigen Anfrage empfangen wurde. Wenn Sie die nächste Datenseite abrufen möchten, übergeben Sie `pageToken` als Eingabeparameter in der nächsten Anfrage.	Optional

Antworten auf Prognosen auf Minutenebene

Die Weather API gibt die folgenden Felder im Antworttext zurück:

Feld	Beschreibung
`overallPredictionTimeframe`	Der Gesamtzeitraum für die Vorhersagen.
`overallPredictionTimeframe.startTime`	Der Beginn des Vorhersagezeitraums. Dies spiegelt den ursprünglichen Referenzpunkt wider.
`overallPredictionTimeframe.endTime`	Die Endzeit des Vorhersagezeitraums. Die Erinnerung wird sechs Stunden nach der Startzeit festgelegt.
`timeZone`	Die Zeitzone des angeforderten Standorts.
`segments`	Die Vorhersagesegmente auf Minutenebene, gekennzeichnet durch `timeFrame`.
`segments.timeFrame`	Der für das Segment relevante Zeitraum.
`segments.timeFrame.startTime`	Die Startzeit des Segments.
`segments.timeFrame.endTime`	Das Ende des Segments.
`segments.type`	Die vorhergesagte Art des Niederschlags während dieses Segments. Mögliche Werte: `DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED` `NONE` `RAIN` `SNOW` `HAIL`
`segments.probability`	Die vorhergesagte Wahrscheinlichkeit von Niederschlag während dieses Segments. Die Werte sind Prozentsätze zwischen 0 und 100.
`segments.qpf`	Die quantitative Niederschlagsvorhersage.
`segments.qpf.quantity`	Die vorhergesagte Niederschlagsmenge während dieses Segments.
`segments.qpf.unit`	Die Einheit, die zum Messen der Menge des angesammelten Niederschlags verwendet wird (z. B. `MILLIMETERS` oder `INCHES`).
`segments.snowfallAmount`	Die vorhergesagte Schneemenge während dieses Zeitraums.
`segments.snowfallAmount.quantity`	Die prognostizierte Schneemenge (als Flüssigwasseräquivalent) während dieses Segments.
`segments.snowfallAmount.unit`	Die Einheit, mit der die Menge des angesammelten Schnees gemessen wird (z. B. `MILLIMETERS`, `INCHES`).
`segments.intensity`	Die Niederschlagsintensität des Segments. Mögliche Werte: `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `LIGHT` `MODERATE` `HEAVY`
`nextPageToken`	Ein Token, das als `pageToken` gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Beispiel für eine minutengenaue Prognose

Im folgenden Beispiel werden minütliche Prognosedaten für einen Standort in West Virginia angefordert:

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"

In der Antwort gibt das segments-Objekt jedes Segment des gesamten Prognosezeitraums an:

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