Der Endpunkt publicAlerts enthält Details zu bestimmten Wetterereigniswarnungen, die von maßgeblichen nationalen und internationalen Behörden ausgegeben wurden. Diese Benachrichtigungen enthalten wichtige, möglicherweise lebensrettende Informationen.
Der Endpunkt gibt Wetterwarnungen zurück, die in Echtzeit für einen bestimmten Breiten- und Längengrad ausgegeben werden. 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:Schneestürme, Hurrikane, Tornados, tropische Stürme, Gewitter und mehr
- Beeinträchtigungen der Sicht:Nebel, Staubstürme und Schneetreiben
- Gefahren im Zusammenhang mit Wasser:Überschwemmungen, Tsunamis, Sturmfluten, Küstengefahren und mehr
- Geophysikalische und geologische Ereignisse:Erdbeben, Erdrutsche und vulkanische Aktivitäten
- Brände:Waldbrände, Brandwetter und mehr
Eine vollständige Liste der unterstützten Wetterereignisse finden Sie unter Wetterereignistypen.
Benachrichtigungen können lokalisierte Beschreibungen enthalten oder nicht, je nachdem, was in der Datenquelle verfügbar ist. Aufgrund von Einschränkungen bei der Datenquelle werden die Informationen unverändert (Rohinhalte) bereitgestellt. Weitere Informationen zu den Quellen für Wetterwarnungen finden Sie unter Datenquellen.
Die API gibt die folgenden Informationen für eine bestimmte Wetterwarnung zurück:
- Der Typ des Wetterereignisses, das mit der Benachrichtigung verknüpft ist
- Eine Liste der betroffenen Gebiete mit Koordinaten, die die geografischen Grenzen dieser Gebiete definieren
- Eine Zusammenfassung des Wetterereignisses in einem Satz
- Schweregrad-, Gewissheits- und Dringlichkeitsstufen
- Eine Beschreibung der Anweisungen für die Zielgruppe, die zu einer Aktion auffordern
- Sicherheitsempfehlungen
- Start- und Endzeit für die Benachrichtigung
- Name und Website der Veröffentlichungsbehörde
Mit dem APIs Explorer können Sie Liveanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:
Wetterwarnungen
Wenn Sie Informationen zu Wetterwarnungen 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
Fügen Sie die Koordinaten von Längen- und Breitengraden des Standorts in die URL-Parameter Ihrer Anfrage ein.
Antworten auf Wetterwarnungen
Die Weather API gibt die folgenden Felder im Antworttext zurück:
| Feld | Typ | Description | Erforderlich oder optional |
|---|---|---|---|
alertId |
String | Die Benachrichtigungs-ID. Diese Informationen finden Sie auch auf der Website des Datenanbieters. | Erforderlich |
alertTitle |
String | Der Titel der Benachrichtigung, der das Wetterereignis beschreibt. Hinweis:Dies ist der einzige String, der übersetzt wird, wenn in der Anfrage ein Sprachcodeparameter enthalten ist. |
Erforderlich |
eventType |
Enum | Der Typ des Wetterereignisses, das mit der Benachrichtigung verknüpft ist. Eine vollständige Liste der unterstützten Wetterereignisse finden Sie unter Wetterereignistypen. |
Erforderlich |
areaName |
String | Der Name des geografischen Gebiets, das von der Benachrichtigung betroffen ist, einschließlich des angeforderten Standorts. | Erforderlich |
polygon |
String | Koordinaten, die einen geschlossenen dimensionalen Bereich der Benachrichtigung definieren. | Optional |
description |
String | Eine kurze Formulierung, die die Ereignisbeschreibung in der angegebenen Sprache zusammenfasst (z. B. „Tornadowarnung“). | Optional |
severity |
Enum | Schweregrad der Benachrichtigung:
|
Optional |
certainty |
Enum | Die Wahrscheinlichkeit für die Warnung:
|
Optional |
urgency |
Enum | Dringlichkeitsstufe der Benachrichtigung:
|
Optional |
instruction |
String | Beschreibung der responsiven Handlungsanweisungen für die Zielgruppe. | Optional |
safetyRecommendations |
String | Sicherheitsempfehlungen basierend auf den Codes von Behörden. Enthält Direktiven der obersten Ebene und Untertext mit zusätzlichen Informationen. | Optional |
timezoneOffset |
String | Die Zeitzonenverschiebung des Ereignisses im Format +/-HH:MM. | Erforderlich |
startTime |
Datum/Uhrzeit | Das effektive Epochen-Datum und die ‑Uhrzeit (UTC) der Informationen in der Benachrichtigung. | Optional |
expirationTime |
Datum/Uhrzeit | Das Epoch-Datum und die ‑Uhrzeit (UTC), zu der eine Benachrichtigung voraussichtlich endet. Bei Ereignissen, die auf unbestimmte Zeit andauern, kann der Wert null sein. In diesem Fall wird in der Überschrift angegeben, dass das Ereignis „in Kraft“ ist. | Optional |
dataSource |
Enum | Details zur Autorität, einschließlich Publisher, Name und URL. | Erforderlich |
regionCode |
Enum | Regionscode des angeforderten Standorts. | Optional |
Datenquellen
Der Endpunkt für Wetterwarnungen gibt Daten zurück, die von den in der folgenden Tabelle aufgeführten Anbietern veröffentlicht wurden. Anhand der in der Anfrage angegebenen Breiten- und Längengradkoordinaten werden im Antworttext Daten der zuständigen lokalen Behörde angezeigt.
Anbieter, die im Feed enthalten sind, halten sich an die Richtlinien für öffentliche Warnungen von Google. Google kann die Liste der Anbieter jederzeit aktualisieren.
Attribution
Auf allen Displays, auf denen die Daten präsentiert werden, muss in der Kundenanwendung die ursprüngliche Quelle über das Feld dataSource angegeben werden:
"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 URL im Feld authorityUri enthalten (z. B. National Weather Service).
Wetterereignistypen
Die folgenden Wetterereignistypen werden unterstützt:
| Wetterereignistypen | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
Übersetzungsverhalten bei Antworten
Google bietet Übersetzungen nur für das Feld alertTitle an. 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 in der Anfrage enthaltenen Parameter languageCode sind für das Feld alertTitle die folgenden Verhaltensweisen zu erwarten:
- Unterstützte
languageCode:Wenn die angefordertelanguageCodesowohl bereitgestellt als auch unterstützt wird, wird die Antwort in der angeforderten Sprache zurückgegeben. - Nicht unterstützte
languageCode:Wenn die angefordertelanguageCodenicht unterstützt wird und keine ähnliche Alternative gefunden werden kann, gibt der Endpunkt die Antwort standardmäßig auf Englisch zurück. - Kein
languageCodeangegeben:Der Endpunkt gibt die Antwort standardmäßig auf Englisch zurück.
Beispiel für eine Anfrage zu Wetterwarnungen
Im folgenden Beispiel werden Informationen zu 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 stellen, um sich mit der API und den API-Optionen vertraut zu machen.
Klicken Sie rechts auf der Seite auf das API-Symbol api.
Bearbeiten Sie optional die Anfrageparameter.
Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im Bereich „APIs Explorer“ das Symbol für den Vollbildmodus fullscreen aus, um das APIs Explorer-Fenster zu maximieren.