Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Minutengenaue Vorhersage abrufen (Beta)

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

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

Start- und Endzeit des Vorhersagezeitraums
Die Zeitzone des angeforderten Standorts
Start- und Endzeit jedes Vorhersagesegments
Der vorhergesagte Typ, die Wahrscheinlichkeit, die Menge und die Intensität des Niederschlags während jedes Segments

Nutzungsbedingungen

Diese Nutzungsbedingungen werden gemäß Abschnitt 6 (Nutzungsbedingungen für Pre-GA-Angebote) der Google Maps Platform Service Specific Terms herausgegeben, wie zwischen Google und Ihnen vereinbart.

1.1 Anforderungen an die Quellenangabe. Der Kunde muss Google gemäß der Dokumentation eine Quellenangabe machen, wenn er Google Maps-Inhalte aus der Weather API verwendet.

1.2 Einschränkungen. Kunden dürfen Google Maps-Inhalte, die aus der Weather API abgerufen wurden, nicht verwenden, um einen Google-Dienst oder ein Google-Produkt nachzubilden. Sie dürfen beispielsweise keine Daten aus der Weather API in einer Wetter-App oder einem Wettermodell verwenden, dessen Hauptzweck darin besteht, Wetterinformationen bereitzustellen.

1.3 Caching. Kunden können die entsprechenden Google Maps-Inhalte aus der Weather API für den entsprechenden Caching-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.

Google Maps-Inhalte	Caching-Zeitraum
Minutenvorhersagewerte	Eine Stunde. Danach muss der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen.

Anfragen für Minutenvorhersagen

Senden Sie eine HTTP/GET-Anfrage an die folgende URL, um Minutenvorhersagen anzufordern:

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

Fügen Sie die Koordinaten des Längen- und Breitengrades des Standorts in die Anfrageparameter ein.

Anfrageparameter

Der Endpunkt forecast.minutes akzeptiert die folgenden Anfrageparameter:

Parameter	Beschreibung	Erforderlich oder optional
`location.latitude`	Die Koordinaten des Breitengrades des angeforderten Standorts.	Erforderlich
`location.longitude`	Die Koordinaten des Längengrades 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 für Minutenvorhersagen

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

Feld	Beschreibung
`overallPredictionTimeframe`	Der Gesamtzeitraum für die Vorhersagen.
`overallPredictionTimeframe.startTime`	Die Startzeit des Vorhersagezeitraums. Dies ist der anfängliche Referenzpunkt.
`overallPredictionTimeframe.endTime`	Die Endzeit des Vorhersagezeitraums. Diese 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`	Die Endzeit des Segments.
`segments.type`	Der vorhergesagte Niederschlagstyp während dieses Segments. Mögliche Werte: `DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED` `NONE` `RAIN` `SNOW` `HAIL`
`segments.probability`	Die vorhergesagte Wahrscheinlichkeit für Niederschlag während dieses Segments. Die Werte werden in Prozent angegeben und liegen 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`, `INCHES`).
`segments.snowfallAmount`	Die vorhergesagte Schneemenge während dieses Segments.
`segments.snowfallAmount.quantity`	Die vorhergesagte Schneemenge (als Flüssigwasseräquivalent) während dieses Segments.
`segments.snowfallAmount.unit`	Die Einheit, die zum Messen der Menge des angesammelten Schnees verwendet 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 Minutenvorhersage

Im folgenden Beispiel werden Minutenvorhersageinformationen 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 Objekt segments jedes Segment des Gesamtvorhersagezeitraums 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"
    },
    ...
  ]
}