Wetterwarnungen erhalten

Der Endpunkt publicAlerts liefert Details zu bestimmten Wetterwarnungen, die von zuständigen nationalen und internationalen Behörden herausgegeben werden. Diese Warnungen liefern wichtige, potenziell lebensrettende Informationen.

Der Endpunkt gibt Wetterwarnungen in Echtzeit für einen bestimmten Breiten- und Längengrad zurück. Zu den unterstützten Wetterereignissen gehören:

• Niederschlag: Regen, Schnee, Hagel, Dürre und mehr
• Extreme Temperaturen: Kälte, Hitze, Frost, Windchill und Luftfeuchtigkeit
• Wind- und Sturmereignisse: Blizzards, Hurrikane, Tornados, Tropenstürme, Gewitter und mehr
• Sichtbehinderungen: Nebel, Staubstürme und Schneetreiben
• Wasserbedingte Gefahren: Überschwemmungen, Tsunamis, Sturmfluten, Küstengefahren und mehr
• Geophysikalische und geologische Ereignisse: Erdbeben, Erdrutsche und vulkanische Aktivitäten
• Brände: Waldbrände, Wetterbedingungen, die Brände begünstigen, und mehr

Eine vollständige Liste der unterstützten Wetterereignisse finden Sie unter Wetterereignistypen.

Warnungen können lokalisierte Beschreibungen enthalten, je nachdem, was in der Datenquelle verfügbar ist. Aufgrund von Einschränkungen der Datenquelle werden die Informationen unverändert (als Rohinhalt) bereitgestellt. Weitere Informationen zu den Quellen für Unwetterwarnungen finden Sie unter Datenquellen.

Die API gibt die folgenden Informationen für eine bestimmte Wetterwarnung zurück:

• Die Art des Wetterereignisses, auf das sich die Warnung bezieht
• Eine Liste der betroffenen Gebiete mit Koordinaten, die die geografischen Grenzen dieser Gebiete definieren
• Eine Zusammenfassung des Wetterereignisses in einem Satz
• Schweregrad, Gewissheit und Dringlichkeit
• Eine Beschreibung der empfohlenen Maßnahmen für die Zielgruppe
• Sicherheitsempfehlungen
• Start- und Endzeit für die Benachrichtigung
• Name und Website der veröffentlichenden Behörde

Mit dem APIs Explorer können Sie Liveanfragen senden, um sich mit der API und den API-Optionen vertraut zu machen:

Anfragen vom Typ „Wetterwarnungen“

Wenn Sie Informationen zu Unwetterwarnungen anfordern möchten, senden Sie eine HTTP-GET-Anfrage an:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

Geben Sie die Koordinaten für den Breiten- und Längengrad des Standorts in den URL-Parametern der Anfrage an.

Antworten auf Wetterwarnungen

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

Datenquellen

Der Endpunkt für Wetterwarnungen gibt Daten zurück, die von den in der folgenden Tabelle aufgeführten Anbietern veröffentlicht wurden. Basierend auf den in der Anfrage angegebenen Breiten- und Längengradkoordinaten werden im Antworttext Daten der entsprechenden lokalen Behörde angezeigt.

Die im Feed enthaltenen Anbieter halten sich an die Richtlinien für Google Warnungen. Google kann die Liste der Anbieter jederzeit aktualisieren.

Attribution

Auf allen Displays, auf denen die Daten präsentiert werden, muss die Kundenanwendung eine Quellenangabe zur ursprünglichen Quelle enthalten, die das Feld dataSource verwendet:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

Die Quellenangabe muss den vollständigen Namen der Datenquelle (wie im Feld name angegeben) und einen Hyperlink zur Datenquelle mit der im Feld authorityUri angegebenen URL enthalten (z. B. „National Weather Service“).

Wetterereignistypen

Die folgenden Wetterereignistypen werden unterstützt:

Verhalten bei der Übersetzung von Antworten

Google stellt nur Übersetzungen für das Feld alertTitle bereit. Andere Felder wie eventType, areaName, instruction und safetyRecommendations können je nach Sprachunterstützung der ursprünglichen Datenquelle ebenfalls übersetzt werden. Google kann jedoch keine unabhängigen Übersetzungen für diese Felder bereitstellen.

Basierend auf dem Parameter languageCode in der Anfrage wird für das Feld alertTitle folgendes Verhalten erwartet:

• Unterstützte languageCode: Wenn die angeforderte languageCode sowohl bereitgestellt als auch unterstützt wird, wird die Antwort in der angeforderten Sprache zurückgegeben.
• Nicht unterstützte languageCode: Wenn die angeforderte languageCode nicht unterstützt wird und keine ähnliche Alternative gefunden werden kann, gibt der Endpunkt die Antwort standardmäßig auf Englisch zurück.
• Keine languageCode angegeben: Der Endpunkt gibt die Antwort standardmäßig auf Englisch zurück.

Beispiel für eine Anfrage zu Wetterwarnungen

Im folgenden Beispiel werden Wetterwarnungen für eine Stadt in North Carolina angefordert:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

Der Antworttext sieht so aus:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

Testen!

Mit dem APIs Explorer können Sie Beispielanfragen erstellen, um sich mit der API und den API-Optionen vertraut zu machen.

1. Wählen Sie rechts auf der Seite das API-Symbol api aus.

2. Bearbeiten Sie optional die Anfrageparameter.

3. Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

4. Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster zu maximieren.