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 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 Vorhersagesegments
Der vorhergesagte Typ, die Wahrscheinlichkeit, die Menge und die Intensität des Niederschlags während jedes Segments

Nutzungsbedingungen

Diese Bedingungen werden gemäß Paragraf 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 an die Quellenangabe. Der Kunde muss Google gemäß der Dokumentation eine Quellenangabe zur Verfügung stellen, wenn er Google Maps-Inhalte aus der Weather API verwendet.

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, die über die Weather API abgerufen werden, 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 (Berechtigungen für das Caching)

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
Prognosewerte für die Minute	Eine Stunde, nach der der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen muss

Anfragen für Prognosen pro Minute

Wenn Sie Prognosen auf Minutenebene 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

Nehmen Sie die Koordinaten für Breiten- und Längengrad des Standorts in die Anfrageparameter auf.

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. Um die nächste Datenseite abzurufen, ü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`	Die Startzeit des Vorhersagezeitraums. Dies entspricht dem ursprünglichen Referenzpunkt.
`overallPredictionTimeframe.endTime`	Das Ende des Vorhersagezeitraums. Diese wird sechs Stunden nach dem Startzeitpunkt festgelegt.
`timeZone`	Die Zeitzone des angeforderten Orts.
`segments`	Die Vorhersagesegmente auf Minutenebene, die mit `timeFrame` gekennzeichnet sind.
`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 Regenwahrscheinlichkeit 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 prognostizierte Schneemenge während dieses Segments.
`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 Prognose auf Minutenebene

Im folgenden Beispiel werden Prognoseinformationen für eine Minute für einen Ort 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"

Im Antwortobjekt segments wird jedes Segment des gesamten Vorhersagezeitraums angegeben:

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