Method: publicAlerts.lookup

Renvoie les alertes météo publiques pour un lieu donné.

Requête HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
location

object (LatLng)

Obligatoire. Position pour laquelle obtenir des alertes météo publiques. Le service renverra les alertes dont la zone concernée croise ce lieu.
pageSize

integer

Facultatif. Nombre maximal d'enregistrements d'alertes météo publiques à renvoyer par page.
pageToken

string

Facultatif. Jeton de page reçu d'un appel publicAlerts.lookup précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à publicAlerts.lookup doivent correspondre à l'appel ayant fourni le jeton de page.
languageCode

string

Facultatif. Permet au client de choisir la langue de la réponse. Si aucune donnée n'est disponible pour cette langue, l'API utilise la langue la plus proche. Les valeurs autorisées sont basées sur la norme IETF BCP-47. La valeur par défaut est "en".

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse pour le RPC publicAlerts.lookup.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Champs
weatherAlerts[]

object (PublicAlerts)

Enregistrements d'alertes météo publiques, selon le nombre d'alertes et la taille de page spécifiés dans la requête.
regionCode

string

Code ISO_3166-1 alpha-2 de la région correspondant à la zone géographique fournie dans la requête. La région est indiquée à l'aide du code ISO_3166-1_alpha-2.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

PublicAlerts

Représente les alertes météo publiques.

Représentation JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
Champs
alertId

string

Identifiant unique de cette alerte.
alertTitle

object (LocalizedText)

Titre localisé de l'alerte.
eventType

enum (WeatherEventType)

Type d'événement météorologique.
areaName

string

Nom de la zone où l'alerte est émise.
instruction[]

string

Instructions recommandées par l'éditeur. Veuillez noter que ce champ doit être localisé, mais cela n'est pas garanti.
safetyRecommendations[]

object (SafetyRecommendation)

Recommandations de sécurité à l'intention de l'utilisateur, qui peuvent être fournies par l'éditeur ou d'autres autorités.
timezoneOffset

string

Décalage du fuseau horaire par rapport à UTC pour le lieu de l'alerte. La valeur est mise en forme sous la forme d'une chaîne se terminant par "s", par exemple : "-14400s" pour 4 heures de retard sur l'heure UTC.
startTime

string (Timestamp format)

Heure de début de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Heure d'expiration de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Détails de l'éditeur qui a émis l'alerte.
polygon

string

Représentation GeoJSON des zones où l'alerte est émise.

Les données GeoJSON doivent être au format RFC 7946 et représenter un polygone (pour une seule zone contiguë) ou un multipolygone (pour plusieurs zones distinctes).

Exemple :

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Voici un exemple de chaîne GeoJSON MultiPolygon :

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

Dernier texte décrivant l'alerte telle qu'elle a été émise par l'autorité officielle. Veuillez noter que ce champ doit être localisé, mais cela n'est pas garanti.
severity

enum (Severity)

Niveau de gravité de l'alerte.
certainty

enum (Certainty)

La certitude de l'alerte.
urgency

enum (Urgency)

L'urgence de l'alerte.

WeatherEventType

Type d'événement météorologique.

Enums
WEATHER_EVENT_TYPE_UNSPECIFIED Type d'événement météorologique non spécifié.
ACID_RAIN Pluies acides.
AFTERSHOCK Réplique
AVALANCHE Événement d'avalanche.
BLIZZARD Événement Blizzard.
BLOWING_SNOW Rafales de neige
BUSHFIRE Feu de brousse
COASTAL_FLOOD Événement d'inondations côtières.
COASTAL_HAZARD Événement de risque côtier.
COLD Événement froid.
CYCLONE Événement cyclonique.
DROUGHT Événement de sécheresse.
DUST_STORM Événement de tempête de poussière.
EARTHQUAKE Événement sismique.
EXTRATROPICAL_CYCLONE Événement de cyclone extratropical.
FIRE Événement de tir.
FIRE_WEATHER Événement météorologique lié aux incendies.
FLASH_FLOOD Événement de crues soudaines.
FLOOD Événement d'inondations.
FOG Événement de brouillard.
FREEZING Le téléphone se fige.
FREEZING_AIR_TEMPERATURE Événement de température de l'air glaciale.
FREEZING_DRIZZLE Événement de bruine verglaçante.
FREEZING_RAIN_EVENT Événement de pluie verglaçante.
FROST Événement de gel.
GALE Événement de vent fort.
GLAZE Événement de glaçage.
HAIL Événement de grêle.
HAZARDOUS_SEAS Événement de conditions maritimes dangereuses.
HEAT Événement de chauffage.
HUMIDITY Événement d'humidité.
HURRICANE Événement Ouragan.
ICE_STORM Tempête de verglas.
INDUSTRIAL_FIRE Incendie industriel
LAKE_EFFECT_SNOW Événement de neige d'effet de lac.
LANDSLIDE Événement de glissement de terrain.
MONSOON Événement de mousson.
MUDDY_FLOOD Événement d'inondations boueuses.
OUTFLOW Événement de sortie.
RADIATION Événement de radiation.
RAIN_EVENT Événement de pluie.
RIVER_FLOODING Événement d'inondations fluviales.
SEVERE_THUNDERSTORM_WARNING Événement de vigilance orages violents.
SNOWSQUALL Événement de bourrasque de neige.
SNOW_EVENT Événement neigeux.
STORM Événement météorologique.
STORM_SURGE Événement d'onde de tempête.
THUNDER Événement Thunder.
THUNDERSTORM Événement orageux.
TORNADO Tornade
TORNADO_WARNING Événement d'avertissement de tornade.
TROPICAL_CYCLONE Événement de cyclone tropical.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Événement de vigilance et d'alerte cyclone tropical.
TROPICAL_DISTURBANCE Événement de perturbation tropicale.
TROPICAL_STORM Tempête tropicale.
TSUNAMI Tsunami
TYPHOON Événement typhon.
VOLCANIC_ASH Événement de cendres volcaniques.
VOLCANIC_ERUPTION Éruption volcanique
WILDFIRE Incendie de forêt.
WIND Événement de vent.
WIND_CHILL Événement de vent froid.
WIND_WAVE Événement de vagues de vent.
WINTER_STORM Tempête hivernale

Gravité

Code indiquant la gravité de l'événement concerné par le message d'alerte.

Enums
SEVERITY_UNKNOWN Gravité inconnue.
EXTREME Menace extraordinaire pour les biens ou les personnes.
SEVERE Menace importante pour les personnes ou les biens.
MODERATE Menace potentielle pour la vie ou les biens.
MINOR Menace mineure pour les biens ou les personnes.

Certitude

Code indiquant la certitude de l'événement concerné par le message d'alerte.

Enums
CERTAINTY_UNKNOWN Certitude inconnue.
OBSERVED Déterminé comme s'étant produit ou étant en cours.
VERY_LIKELY Très probablement.
LIKELY Probable (p > ~50 %).
POSSIBLE Possible, mais peu probable (p <= ~50 %).
UNLIKELY Peu probable (p ~ 0 %).

Urgence

Code indiquant l'urgence de l'événement concerné par le message d'alerte.

Enums
URGENCY_UNKNOWN Urgence inconnue.
IMMEDIATE Une action réactive DOIT être entreprise immédiatement.
EXPECTED Une action réactive DOIT être entreprise rapidement (dans l'heure qui suit).
FUTURE Une action réactive DOIT être entreprise dans un avenir proche.
PAST Aucune action n'est requise de votre part.

SafetyRecommendation

Représente une recommandation de sécurité.

Représentation JSON 
{
  "directive": string,
  "subtext": string
}
Champs
directive

string

Une directive à l'intention de l'utilisateur. Veuillez noter que ce champ doit être localisé, mais cela n'est pas garanti.
subtext

string

Sous-texte facultatif pour la directive, qui peut contenir du contexte supplémentaire pour l'utilisateur. Veuillez noter que ce champ doit être localisé, mais cela n'est pas garanti.

DataSource

Représente un lien vers une source de données.

Représentation JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Champs
publisher

enum (Publisher)

Éditeur de l'alerte.
name

string

Nom officiel de l'éditeur. Veuillez noter que ce champ doit être localisé, mais cela n'est pas garanti.
authorityUri

string

URL du site Web de l'autorité.

Éditeur

Éditeur de l'alerte.

Enums
PUBLISHER_UNSPECIFIED Éditeur non spécifié.
AUSTRALIA_ACT_ESA Australie, Territoire de la capitale australienne
AUSTRALIA_NSW_RFS Nouvelle-Galles du Sud
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Australie-Méridionale
METEO_ALARM_AT Meteoalarm / EUMETNET Autriche
METEO_ALARM_BS Bosnie
BRAZIL_CENAD Agence brésilienne de gestion des catastrophes au Brésil
BRAZIL_INMET Agence météorologique au Brésil
UK_ENV_AGENCY Royaume-Uni
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgarie
METEO_ALARM_CR Croatie
METEO_ALARM_CY Chypre
METEO_ALARM_CS Tchéquie
METEO_ALARM_DK Danemark
EC_INAMHI Équateur
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR France
DE_DWD Allemagne
METEO_ALARM_GB Meteoalarm / EUMETNET Grande-Bretagne
METEO_ALARM_GR Grèce
METEO_ALARM_HU Hongrie
METEO_ALARM_IS Islande
METEO_ALARM_IE Irlande
METEO_ALARM_IT Italie
JM_JMS Jamaïque
JMA Japon
METEO_ALARM_NL Meteoalarm / EUMETNET Pays-Bas
METEO_ALARM_LV Lettonie
METEO_ALARM_LT Lituanie
METEO_ALARM_LU Luxembourg
MEXICO_CIRES Mexique CIRES
NZ_GEONET Nouvelle-Zélande GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Macédoine du Nord
METEO_ALARM_NO Norvège
PHILIPPINES_PAGASA Philippines
METEO_ALARM_PL Meteoalarm / EUMETNET Pologne
METEO_ALARM_PT Portugal
METEO_ALARM_RO Roumanie
METEO_ALARM_RS Serbie
SG_MSS Singapour
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI Slovénie
SB_MET Îles Salomon
METEO_ALARM_ES Meteoalarm / EUMETNET Espagne
METEO_ALARM_SE Suède
METEO_ALARM_CH Suisse
TAIWAN_NCDR Taïwan
NOAA NOAA (États-Unis)
WCATWC Centre national d'alerte aux tsunamis