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 Standorts
- Start- und Endzeit jedes Prognosesegments
- Der vorhergesagte Typ, die Wahrscheinlichkeit, die Menge und die Intensität des Niederschlags während jedes Segments
Nutzungsbedingungen
Diese Bedingungen werden gemäß Paragraf 6 (Pre-GA-Angebotsbedingungen) der dienstspezifischen Nutzungsbedingungen für die Google Maps Platform herausgegeben, denen Sie und Google zugestimmt haben.
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 wurden, nicht verwenden, um einen Google-Dienst oder ein Google-Produkt nachzubilden (z.B. Daten, die über die Weather API abgerufen wurden, in einer Wetter-App oder einem Wettermodell verwenden, deren 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.
| Inhalte aus Google Maps | Caching-Zeitraum |
|---|---|
| Prognosewerte für Minuten | Eine Stunde, danach muss der Kunde die im Cache gespeicherten Google Maps-Inhalte löschen |
Anfragen für Minutenprognosen
Wenn Sie Prognosen für die nächsten 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 Breiten- und Längengradkoordinaten 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:
Wenn kein Einheitensystem angegeben ist, wird standardmäßig |
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 zur Prognose pro Minute
Die Weather API gibt im Antworttext die folgenden Felder zurück:
| Feld | Beschreibung |
|---|---|
overallPredictionTimeframe |
Der Gesamtzeitraum für die Prognosen. |
overallPredictionTimeframe.startTime |
Der Beginn des Vorhersagezeitraums. Dies ist der ursprüngliche Referenzpunkt. |
overallPredictionTimeframe.endTime |
Das Ende des Vorhersagezeitraums. Diese wird auf sechs Stunden nach dem Beginn festgelegt. |
timeZone |
Die Zeitzone des angeforderten Standorts. |
segments |
Die Vorhersagesegmente auf Minutenebene, die durch timeFrame gekennzeichnet sind. |
segments.timeFrame |
Der für das Segment relevante Zeitraum. |
segments.timeFrame.startTime |
Der Beginn des Segments. |
segments.timeFrame.endTime |
Das Ende des Segments. |
segments.type |
Die vorhergesagte Art des Niederschlags während dieses Zeitraums. Mögliche Werte:
|
segments.probability |
Die vorhergesagte Niederschlagswahrscheinlichkeit während dieses Zeitraums. Die Werte sind Prozentsätze zwischen 0 und 100. |
segments.qpf |
Die quantitative Niederschlagsvorhersage. |
segments.qpf.quantity |
Die vorhergesagte Niederschlagsmenge während dieses Zeitraums. |
segments.qpf.unit |
Die Einheit, die zur Messung der kumulierten Niederschlagsmenge 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 Zeitraums. |
segments.snowfallAmount.unit |
Die Einheit, die zur Messung der Menge des angesammelten Schnees verwendet wird (z. B. MILLIMETERS, INCHES). |
segments.intensity |
Die Niederschlagsintensität des Segments (PrecipitationIntensity). Mögliche Werte:
Hinweis: Ihr Client muss unbekannte Werte verarbeiten können. |
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 nach Minuten
Im folgenden Beispiel werden Informationen zur Minutenvorhersage 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 Vorhersagezeitraums 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" }, ... ] }