Le point de terminaison publicAlerts fournit des informations sur les alertes d'événements météorologiques spécifiques émises par des agences nationales et internationales reconnues. Ces alertes fournissent des informations cruciales qui peuvent sauver des vies.
Le point de terminaison renvoie les alertes météo en temps réel pour une latitude et une longitude données. Voici les événements météorologiques acceptés :
- Précipitations : pluie, neige, grêle, sécheresse, etc.
- Températures extrêmes : froid, chaleur, gel, gelée, température ressentie et humidité
- Événements liés au vent et aux tempêtes : blizzards, ouragans, tornades, tempêtes tropicales, orages, etc.
- Visibilité réduite : brouillard, tempêtes de poussière et rafales de neige
- Risques liés à l'eau : inondations, tsunamis, ondes de tempête, risques côtiers, etc.
- Événements géophysiques et géologiques : séismes, glissements de terrain et activité volcanique
- Incendies : feux de forêt, conditions météorologiques propices aux incendies, etc.
Pour obtenir la liste complète des événements météorologiques acceptés, consultez Types d'événements météorologiques.
Les alertes peuvent contenir ou non des descriptions localisées, selon ce qui est disponible dans la source de données. En raison des restrictions liées aux sources de données, les informations sont fournies telles quelles (contenu brut). Pour en savoir plus sur les sources des alertes météo, consultez Sources de données.
L'API renvoie les informations suivantes pour une alerte météo donnée :
- Type d'événement météorologique associé à l'alerte
- Liste des zones concernées, avec les coordonnées définissant les limites géographiques de ces zones
- Résumé de l'événement météorologique en une phrase
- Niveaux de gravité, de certitude et d'urgence
- Description des instructions d'action recommandées pour l'audience cible
- Recommandations de sécurité
- Heures de début et de fin de l'alerte
- Nom et site Web de l'autorité de publication
APIs Explorer vous permet d'envoyer des requêtes en direct pour vous familiariser avec l'API et ses options :
À propos des demandes d'alertes météo
Pour demander des informations sur les alertes météo, envoyez une requête HTTP GET à l'adresse suivante :
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
Incluez les coordonnées de latitude et de longitude du lieu dans les paramètres de l'URL de votre requête.
À propos des réponses aux alertes météo
L'API Weather renvoie les champs suivants dans le corps de la réponse :
| Champ | Type | Description | Obligatoire ou facultatif |
|---|---|---|---|
alertId |
Chaîne | ID de l'alerte. Vous pouvez également les trouver sur le site Web du fournisseur de données. | Obligatoire |
alertTitle |
Chaîne | Titre de l'alerte décrivant l'événement météorologique. Remarque : Il s'agit de la seule chaîne traduite lorsqu'un paramètre de code de langue est inclus dans la requête. |
Obligatoire |
eventType |
Énumération | Type d'événement météorologique associé à l'alerte. Pour obtenir la liste complète des événements météorologiques acceptés, consultez Types d'événements météorologiques. |
Obligatoire |
areaName |
Chaîne | Nom de la zone géographique concernée par l'alerte, y compris le lieu demandé. | Obligatoire |
polygon |
Chaîne | Coordonnées définissant une zone dimensionnelle fermée de l'alerte. | Facultatif |
description |
Chaîne | Brève expression qui résume la description de l'événement dans la langue spécifiée (par exemple, "Alerte de tornade"). | Facultatif |
severity |
Énumération | Niveau de gravité de l'alerte :
|
Facultatif |
certainty |
Énumération | Niveau de certitude de l'alerte :
|
Facultatif |
urgency |
Énumération | Niveau d'urgence de l'alerte :
|
Facultatif |
instruction |
Chaîne | Description des instructions d'action responsives pour l'audience cible. | Facultatif |
safetyRecommendations |
Chaîne | Recommandations de sécurité basées sur les codes des autorités publiques. Inclut des directives de premier niveau et un sous-texte contenant des informations supplémentaires. | Facultatif |
timezoneOffset |
Chaîne | Décalage horaire de l'événement, au format +/-HH:MM. | Obligatoire |
startTime |
DateTime | Date et heure effectives (en temps UTC) des informations contenues dans le message d'alerte. | Facultatif |
expirationTime |
DateTime | Date et heure Epoch (heure UTC) auxquelles une alerte devrait se terminer. Elle peut être nulle pour les événements de durée indéterminée, auquel cas le titre indiquera que l'événement est "en cours". | Facultatif |
dataSource |
Énumération | Informations sur l'autorité, y compris l'éditeur, le nom et l'URL. | Obligatoire |
regionCode |
Énumération | Code de région de l'emplacement demandé. | Facultatif |
Sources de données
Le point de terminaison des alertes météo renvoie les données publiées par les fournisseurs listés dans le tableau suivant. En fonction des coordonnées de latitude et de longitude fournies dans la requête, le corps de la réponse affiche les données de l'autorité locale appropriée.
Les fournisseurs inclus dans le flux respectent les Consignes de Google concernant les alertes publiques. Google peut mettre à jour la liste des fournisseurs à tout moment.
Attribution
Sur tous les écrans où les données sont présentées, l'application cliente doit inclure une attribution à la source d'origine à l'aide du champ dataSource :
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
L'attribution doit inclure le nom complet de la source de données (tel qu'indiqué dans le champ name) et un lien hypertexte vers la source de données à l'aide de l'URL fournie dans le champ authorityUri (par exemple, National Weather Service).
Types d'événements météorologiques
Les types d'événements météorologiques suivants sont acceptés :
| Types d'événements météorologiques | |
|---|---|
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 |
Comportement de traduction des réponses
Google ne fournit des traductions que pour le champ alertTitle. D'autres champs tels que eventType, areaName, instruction et safetyRecommendations peuvent également être traduits, en fonction des langues acceptées par la source de données d'origine. Toutefois, Google ne peut pas fournir de traductions indépendantes pour ces champs.
En fonction du paramètre languageCode inclus dans la requête, les comportements suivants sont attendus pour le champ alertTitle :
languageCodeacceptée : si lalanguageCodedemandée est fournie et acceptée, la réponse est renvoyée dans la langue demandée.languageCodenon compatible : si lelanguageCodedemandé n'est pas compatible et qu'aucune alternative proche ne peut être trouvée, le point de terminaison renvoie la réponse en anglais par défaut.- Aucun
languageCodefourni : le point de terminaison renvoie la réponse en anglais par défaut.
Exemple de demande d'alerte météo
L'exemple suivant demande des informations sur les alertes météo pour une ville de Caroline du Nord :
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
Le corps de la réponse est le suivant :
{ "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" }
Essayer
APIs Explorer vous permet d'effectuer des exemples de requêtes pour vous familiariser avec l'API et ses options.
Sélectionnez l'icône API api à droite de la page.
Vous pouvez également modifier les paramètres de la requête.
Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour envoyer la demande.
Dans le panneau APIs Explorer, sélectionnez l'icône plein écran fullscreen pour développer la fenêtre APIs Explorer.