Method: publicAlerts.lookup

Restituisce allerte meteo pubbliche per una determinata località.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
location

object (LatLng)

Obbligatorio. La località per cui ricevere allerte meteo pubbliche. Il servizio restituirà gli avvisi la cui area interessata interseca questa posizione.
pageSize

integer

Facoltativo. Il numero massimo di record di avvisi meteo pubblici da restituire per pagina.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata publicAlerts.lookup. Forniscilo per recuperare la pagina successiva. Durante la paginazione, tutti gli altri parametri forniti a publicAlerts.lookup devono corrispondere alla chiamata che ha fornito il token di pagina.
languageCode

string

Facoltativo. Consente al cliente di scegliere la lingua della risposta. Se non è possibile fornire dati per quella lingua, l'API utilizza la corrispondenza più vicina. I valori consentiti si basano sullo standard IETF BCP-47. Il valore predefinito è "en".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per la RPC publicAlerts.lookup.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Campi
weatherAlerts[]

object (PublicAlerts)

I record di avvisi meteo pubblici, in base al numero di avvisi e alle dimensioni della pagina specificati nella richiesta.
regionCode

string

Il codice ISO_3166-1 alpha-2 della regione corrispondente alla località fornita nella richiesta. La regione è indicata utilizzando ISO_3166-1_alpha-2.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

PublicAlerts

Rappresenta le allerte meteo pubbliche.

Rappresentazione 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)
}
Campi
alertId

string

L'identificatore univoco di questo avviso.
alertTitle

object (LocalizedText)

Il titolo localizzato dell'avviso.
eventType

enum (WeatherEventType)

Il tipo di evento meteorologico.
areaName

string

Il nome dell'area in cui viene emesso l'avviso.
instruction[]

string

Istruzioni consigliate dal publisher. Tieni presente che, sebbene questo campo debba essere localizzato, non è garantito che lo sia.
safetyRecommendations[]

object (SafetyRecommendation)

Direttiva con consigli di sicurezza per l'utente, che possono essere forniti dall'editore o da altre autorità.
timezoneOffset

string

La differenza di fuso orario rispetto a UTC per la posizione dell'avviso. Il valore è formattato come una stringa che termina con "s", ad esempio "-14400s" per 4 ore indietro rispetto all'UTC.
startTime

string (Timestamp format)

L'ora di inizio dell'evento.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

L'ora di scadenza dell'evento.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Dettagli del publisher che ha emesso l'avviso.
polygon

string

Una rappresentazione GeoJSON delle aree in cui viene emesso l'avviso.

I dati GeoJSON devono essere in formato RFC 7946 e rappresentare un poligono (per una singola area contigua) o un multipoligono (per più aree distinte).

Esempio:

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

Un esempio di stringa GeoJSON MultiPolygon è il seguente:

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

string

Il testo più recente che descrive l'avviso emesso dall'autorità ufficiale. Tieni presente che, sebbene questo campo debba essere localizzato, non è garantito che lo sia.
severity

enum (Severity)

Il livello di gravità dell'avviso.
certainty

enum (Certainty)

La certezza dell'avviso.
urgency

enum (Urgency)

L'urgenza dell'avviso.

WeatherEventType

Il tipo di evento meteorologico.

Enum
WEATHER_EVENT_TYPE_UNSPECIFIED Tipo di evento meteorologico non specificato.
ACID_RAIN Evento di pioggia acida.
AFTERSHOCK Evento di scossa di assestamento.
AVALANCHE Evento valanga.
BLIZZARD Evento Blizzard.
BLOWING_SNOW Evento di scaccianeve.
BUSHFIRE Evento di incendio boschivo.
COASTAL_FLOOD Evento di inondazione costiera.
COASTAL_HAZARD Evento di rischio costiero.
COLD Evento freddo.
CYCLONE Evento ciclonico.
DROUGHT Evento di siccità.
DUST_STORM Evento di tempesta di sabbia.
EARTHQUAKE Evento di terremoto.
EXTRATROPICAL_CYCLONE Evento di ciclone extratropicale.
FIRE Evento di fuoco.
FIRE_WEATHER Evento meteorologico di incendio.
FLASH_FLOOD Evento di allagamento improvviso.
FLOOD Evento di inondazione.
FOG Evento nebbia.
FREEZING Evento di blocco.
FREEZING_AIR_TEMPERATURE Evento di temperatura dell'aria gelida.
FREEZING_DRIZZLE Evento di pioviggine congelantesi.
FREEZING_RAIN_EVENT Evento di pioggia sopraffusa.
FROST Evento Frost.
GALE Evento di burrasca.
GLAZE Evento di glassatura.
HAIL Evento di grandine.
HAZARDOUS_SEAS Evento di condizioni del mare pericolose.
HEAT Evento di calore.
HUMIDITY Evento di umidità.
HURRICANE Evento uragano.
ICE_STORM Evento tempesta di ghiaccio.
INDUSTRIAL_FIRE Evento di incendio industriale.
LAKE_EFFECT_SNOW Evento di neve effetto lago.
LANDSLIDE Evento di frana.
MONSOON Evento monsone.
MUDDY_FLOOD Evento di inondazione fangosa.
OUTFLOW Evento di deflusso.
RADIATION Evento di radiazione.
RAIN_EVENT Evento di pioggia.
RIVER_FLOODING Evento di inondazione del fiume.
SEVERE_THUNDERSTORM_WARNING Evento di allarme temporale violento.
SNOWSQUALL Evento Snowsquall.
SNOW_EVENT Evento di neve.
STORM Evento di tempesta.
STORM_SURGE Evento di onda di tempesta.
THUNDER Evento di tuono.
THUNDERSTORM Evento di temporale.
TORNADO Evento di tornado.
TORNADO_WARNING Evento di allarme tornado.
TROPICAL_CYCLONE Evento di ciclone tropicale.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Evento di avvisi e allerte ciclone tropicale.
TROPICAL_DISTURBANCE Evento di perturbazione tropicale.
TROPICAL_STORM Evento di tempesta tropicale.
TSUNAMI Evento tsunami.
TYPHOON Evento tifone.
VOLCANIC_ASH Evento di cenere vulcanica.
VOLCANIC_ERUPTION Evento di eruzione vulcanica.
WILDFIRE Evento di incendio incontrollato.
WIND Evento vento.
WIND_CHILL Evento vento freddo.
WIND_WAVE Evento di onde generate dal vento.
WINTER_STORM Evento tempesta invernale.

Gravità

Il codice che indica la gravità dell'evento oggetto del messaggio di avviso.

Enum
SEVERITY_UNKNOWN Gravità sconosciuta.
EXTREME Minaccia straordinaria alla vita o alle proprietà.
SEVERE Minaccia significativa per la vita o le proprietà.
MODERATE Possibile minaccia per la vita o la proprietà.
MINOR Minaccia minore alla vita o alle proprietà.

Certezza

Il codice che indica la certezza dell'evento oggetto del messaggio di avviso.

Enum
CERTAINTY_UNKNOWN Certezza sconosciuta.
OBSERVED Determinato come avvenuto o in corso.
VERY_LIKELY Molto probabilmente.
LIKELY Probabile (p > ~50%).
POSSIBLE Possibile, ma non probabile (p <= ~50%).
UNLIKELY Improbabile (p ~ 0%).

Urgenza

Il codice che indica l'urgenza dell'evento oggetto del messaggio di avviso.

Enum
URGENCY_UNKNOWN Urgenza sconosciuta.
IMMEDIATE L'azione di risposta DEVE essere intrapresa immediatamente.
EXPECTED L'azione reattiva DOVREBBE essere intrapresa a breve (entro la prossima ora).
FUTURE DOVREBBE essere intrapresa un'azione reattiva nel prossimo futuro.
PAST L'azione reattiva non è più necessaria.

SafetyRecommendation

Rappresenta un consiglio di sicurezza.

Rappresentazione JSON 
{
  "directive": string,
  "subtext": string
}
Campi
directive

string

Un'indicazione per l'utente. Tieni presente che, sebbene questo campo debba essere localizzato, non è garantito che lo sia.
subtext

string

Un sottotesto facoltativo per la direttiva, che può contenere un contesto aggiuntivo per l'utente. Tieni presente che, sebbene questo campo debba essere localizzato, non è garantito che lo sia.

Origine dati

Rappresenta un link a un'origine dati.

Rappresentazione JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Campi
publisher

enum (Publisher)

Il publisher dell'avviso.
name

string

Nome ufficiale dell'editore. Tieni presente che, sebbene questo campo debba essere localizzato, non è garantito che lo sia.
authorityUri

string

L'URL del sito web dell'autorità.

Publisher

Il publisher dell'avviso.

Enum
PUBLISHER_UNSPECIFIED Publisher non specificato.
AUSTRALIA_ACT_ESA Australia Territorio della Capitale Australiana
AUSTRALIA_NSW_RFS Nuovo Galles del Sud
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Australia Meridionale
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS Bosnia
BRAZIL_CENAD Agenzia per i disastri del Brasile
BRAZIL_INMET Agenzia meteorologica in Brasile
UK_ENV_AGENCY Regno Unito
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR Croazia
METEO_ALARM_CY Cipro
METEO_ALARM_CS Repubblica Ceca
METEO_ALARM_DK Danimarca
EC_INAMHI Ecuador
METEO_ALARM_FI Meteoalarm / EUMETNET Finlandia
METEO_ALARM_FR Francia
DE_DWD Germania
METEO_ALARM_GB Meteoalarm / EUMETNET Gran Bretagna
METEO_ALARM_GR Grecia
METEO_ALARM_HU Ungheria
METEO_ALARM_IS Islanda
METEO_ALARM_IE Irlanda
METEO_ALARM_IT Italia
JM_JMS Giamaica
JMA Giappone
METEO_ALARM_NL Meteoalarm / EUMETNET Paesi Bassi
METEO_ALARM_LV Lettonia
METEO_ALARM_LT Lituania
METEO_ALARM_LU Lussemburgo
MEXICO_CIRES Messico Messico CIRES
NZ_GEONET Nuova Zelanda New Zealand GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Macedonia del Nord
METEO_ALARM_NO Norvegia
PHILIPPINES_PAGASA Filippine
METEO_ALARM_PL Meteoalarm / EUMETNET Polonia
METEO_ALARM_PT Portogallo
METEO_ALARM_RO Romania
METEO_ALARM_RS Serbia
SG_MSS Singapore
METEO_ALARM_SK Meteoalarm / EUMETNET Slovacchia
METEO_ALARM_SI Slovenia
SB_MET Isole Salomone
METEO_ALARM_ES Meteoalarm / EUMETNET Spagna
METEO_ALARM_SE Svezia
METEO_ALARM_CH Svizzera
TAIWAN_NCDR Taiwan
NOAA NOAA (Stati Uniti)
WCATWC National Tsunami Warning Center