Package google.maps.weather.v1

Indice

Meteo

Definizione del servizio per l'API Weather.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

Restituisce le condizioni meteo attuali in una determinata località.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

Restituisce fino a 10 giorni di previsioni giornaliere in una determinata località, a partire dal giorno corrente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

Restituisce fino a 240 ore di previsioni orarie in una determinata località, a partire dall'ora corrente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

Restituisce fino a 24 ore di dati meteo storici orari in una determinata località, a partire dall'ultima ora.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

Restituisce allerte meteo pubbliche per una determinata località.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

AirPressure

Rappresenta le condizioni di pressione atmosferica.

Campi
mean_sea_level_millibars

float

La pressione atmosferica media al livello del mare in millibar.

CardinalDirection

Rappresenta una direzione cardinale (incluse le direzioni ordinali).

Enum
CARDINAL_DIRECTION_UNSPECIFIED La direzione cardinale non è specificata.
NORTH Il punto cardinale nord.
NORTH_NORTHEAST La direzione intercardinale secondaria nord-nord-est.
NORTHEAST La direzione intercardinale nord-est.
EAST_NORTHEAST La direzione intercardinale secondaria est-nord-est.
EAST Il punto cardinale est.
EAST_SOUTHEAST La direzione secondaria intercardinale est-sud-est.
SOUTHEAST La direzione intercardinale sud-est.
SOUTH_SOUTHEAST La direzione secondaria intercardinale sud-sud-est.
SOUTH Il punto cardinale sud.
SOUTH_SOUTHWEST La direzione secondaria intercardinale sud-sud-ovest.
SOUTHWEST La direzione intercardinale sud-ovest.
WEST_SOUTHWEST La direzione intercardinale secondaria ovest-sud-ovest.
WEST Il punto cardinale ovest.
WEST_NORTHWEST La direzione secondaria intercardinale ovest-nord-ovest.
NORTHWEST La direzione intercardinale nord-ovest.
NORTH_NORTHWEST La direzione intercardinale secondaria nord-nord-ovest.

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%).

Origine dati

Rappresenta un link a un'origine dati.

Campi
publisher

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.

authority_uri

string

L'URL del sito web dell'autorità.

ForecastDay

Rappresenta un record di previsione giornaliera in una determinata località.

Campi
interval

Interval

L'intervallo di tempo UTC in cui inizia (incluso) e termina (escluso) questo giorno previsto. Nota: un giorno inizia alle 7:00 e termina alle 7:00 del giorno successivo, ora locale. Ad esempio, se il fuso orario locale è UTC-7, l'intervallo inizierà all'ora 14:00:00.000Z e terminerà alla stessa ora del giorno successivo.

display_date

Date

La data locale nel fuso orario della località (ora civile) per cui viene calcolata questa previsione giornaliera. Questo campo può essere utilizzato a scopo di visualizzazione sul client.

daytime_forecast

ForecastDayPart

Le condizioni meteo previste per la parte diurna della giornata (dalle 7:00 alle 19:00 ora locale).

nighttime_forecast

ForecastDayPart

Le condizioni meteo previste per la parte notturna della giornata (dalle 19:00 alle 07:00 del giorno successivo, ora locale).

max_temperature

Temperature

La temperatura massima (alta) durante la giornata.

min_temperature

Temperature

La temperatura minima (bassa) durante il giorno.

feels_like_max_temperature

Temperature

La temperatura percepita massima (alta) durante la giornata.

feels_like_min_temperature

Temperature

La temperatura percepita minima (bassa) durante il giorno.

max_heat_index

Temperature

La temperatura massima dell'indice di calore durante la giornata.

sun_events

SunEvents

Gli eventi relativi al sole (ad es. alba, tramonto).

moon_events

MoonEvents

Gli eventi relativi alla luna (ad es. sorgere della luna, tramonto della luna).

ForecastDayPart

Rappresenta un record di previsione per una parte della giornata.

Campi
interval

Interval

La data e l'ora UTC in cui inizia (inclusa) e termina (esclusa) questa parte della giornata. Nota: una parte della giornata inizia alle 7:00 e termina alle 19:00 dello stesso giorno, ora locale. Ad esempio, se il fuso orario locale è UTC-7, l'intervallo diurno inizierà all'ora 14:00:00.000Z e terminerà alle 02:00:00.000Z del giorno successivo, mentre l'intervallo notturno inizierà alle 02:00:00.000Z del giorno successivo e terminerà alle 14:00:00.000Z dello stesso giorno.

weather_condition

WeatherCondition

La condizione meteo prevista.

precipitation

Precipitation

Le precipitazioni previste.

wind

Wind

La direzione media del vento e la velocità massima e la raffica.

ice_thickness

IceThickness

La quantità di ghiaccio accumulata per la parte della giornata.

relative_humidity

int32

La percentuale prevista di umidità relativa (valori da 0 a 100).

uv_index

int32

L'indice ultravioletto (UV) massimo previsto.

thunderstorm_probability

int32

La probabilità media di temporale.

cloud_cover

int32

Percentuale media di copertura nuvolosa.

ForecastHour

Rappresenta un record di previsione oraria in una determinata posizione.

Campi
interval

Interval

L'intervallo di un'ora (in ora UTC) per cui sono validi questi dati di previsione (i timestamp vengono arrotondati all'ora più vicina).

display_date_time

DateTime

La data e l'ora locali nel fuso orario della località (ora civile) per cui viene calcolata questa previsione oraria. Questo campo può essere utilizzato a scopo di visualizzazione sul client. Nota: questa data sarà composta da anno, mese, giorno, ora e offset rispetto al fuso orario UTC.

weather_condition

WeatherCondition

La condizione meteorologica prevista.

temperature

Temperature

La temperatura prevista.

feels_like_temperature

Temperature

La misura di come si percepirà la temperatura nella località richiesta.

dew_point

Temperature

La temperatura del punto di rugiada prevista.

heat_index

Temperature

La temperatura prevista dell'indice di calore.

wind_chill

Temperature

La temperatura percepita prevista, ovvero la temperatura dell'aria a contatto con la pelle.

wet_bulb_temperature

Temperature

La temperatura di bulbo umido prevista, ovvero la temperatura più bassa raggiungibile evaporando l'acqua.

precipitation

Precipitation

La probabilità di precipitazioni prevista e la quantità di precipitazioni accumulate nell'ultima ora.

air_pressure

AirPressure

Le condizioni di pressione atmosferica previste.

wind

Wind

Le condizioni del vento previste.

visibility

Visibility

La visibilità prevista.

ice_thickness

IceThickness

Lo spessore del ghiaccio previsto.

is_daytime

bool

True se questa ora è compresa tra l'alba (inclusa) e il tramonto (escluso) locali. In caso contrario, è notte (tra il tramonto e l'alba successiva). Nota: questa ora verrà considerata diurna o notturna se l'intervallo si interseca rispettivamente con gli orari locali di alba e tramonto (ad es. se l'intervallo è dalle 5:00 alle 6:00 e l'alba è alle 5:59, allora is_daytime sarà true).

relative_humidity

int32

La percentuale prevista di umidità relativa (valori da 0 a 100).

uv_index

int32

L'indice ultravioletto (UV) previsto.

thunderstorm_probability

int32

La probabilità di temporale prevista (valori da 0 a 100).

cloud_cover

int32

La percentuale prevista di cielo coperto da nuvole (valori da 0 a 100).

HistoryHour

Rappresenta un record della cronologia oraria in una determinata posizione.

Campi
interval

Interval

L'intervallo di un'ora (in ora UTC) per cui sono validi questi dati storici (i timestamp vengono arrotondati all'ora più vicina).

display_date_time

DateTime

La data e l'ora locali nel fuso orario della località (ora civile) per cui viene calcolato questo record orario. Questo campo può essere utilizzato a scopo di visualizzazione sul client. Nota: questa data sarà composta da anno, mese, giorno, ora e offset rispetto al fuso orario UTC.

weather_condition

WeatherCondition

Le condizioni meteo storiche.

temperature

Temperature

La temperatura storica.

feels_like_temperature

Temperature

La misura di come si percepisce la temperatura nella posizione richiesta.

dew_point

Temperature

La temperatura del punto di rugiada storica.

heat_index

Temperature

La temperatura storica dell'indice di calore.

wind_chill

Temperature

Il wind chill storico, la temperatura dell'aria esposta sulla pelle.

wet_bulb_temperature

Temperature

La temperatura di bulbo umido storica, ovvero la temperatura più bassa raggiungibile evaporando l'acqua.

precipitation

Precipitation

La probabilità di precipitazioni storica e la quantità di precipitazioni accumulate nell'ultima ora.

air_pressure

AirPressure

Le condizioni storiche della pressione atmosferica.

wind

Wind

Le condizioni storiche del vento.

visibility

Visibility

La visibilità storica.

ice_thickness

IceThickness

Lo spessore storico del ghiaccio.

is_daytime

bool

True se questa ora è compresa tra l'alba (inclusa) e il tramonto (escluso) locali. In caso contrario, è notte (tra il tramonto e l'alba successiva). Nota: questa ora verrà considerata diurna o notturna se l'intervallo si interseca rispettivamente con gli orari locali di alba e tramonto (ad es. se l'intervallo è dalle 5:00 alle 6:00 e l'alba è alle 5:59, allora is_daytime sarà true).

relative_humidity

int32

La percentuale storica di umidità relativa (valori da 0 a 100).

uv_index

int32

L'indice ultravioletto (UV) storico.

thunderstorm_probability

int32

La probabilità storica di temporali (valori da 0 a 100).

cloud_cover

int32

La percentuale storica di cielo coperto da nuvole (valori da 0 a 100).

IceThickness

Rappresenta le condizioni di spessore del ghiaccio.

Campi
unit

Unit

Il codice che rappresenta l'unità utilizzata per misurare lo spessore del ghiaccio.

thickness

float

Il valore dello spessore del ghiaccio.

Unità

Rappresenta l'unità utilizzata per misurare lo spessore del ghiaccio.

Enum
UNIT_UNSPECIFIED L'unità non è specificata.
MILLIMETERS Lo spessore è misurato in millimetri.
INCHES Lo spessore viene misurato in pollici.

LookupCurrentConditionsRequest

Richiesta della RPC LookupCurrentConditions.

Campi
location

LatLng

Obbligatorio. La posizione per cui ottenere le condizioni meteo attuali.

units_system

UnitsSystem

Facoltativo. Il sistema di unità da utilizzare per le condizioni meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).

language_code

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".

LookupCurrentConditionsResponse

Risposta per l'RPC LookupCurrentConditions, che rappresenta le condizioni meteo attuali nella località richiesta.

Campi
current_time

Timestamp

Ora attuale (UTC) associata ai dati restituiti.

time_zone

TimeZone

Il fuso orario nella posizione richiesta.

weather_condition

WeatherCondition

La condizione meteo attuale.

temperature

Temperature

La temperatura attuale.

feels_like_temperature

Temperature

La misura della temperatura percepita attualmente nella località richiesta.

dew_point

Temperature

La temperatura attuale del punto di rugiada.

heat_index

Temperature

La temperatura attuale dell'indice di calore.

wind_chill

Temperature

L'attuale temperatura percepita, la temperatura dell'aria esposta sulla pelle.

precipitation

Precipitation

La probabilità di precipitazioni attuale e la quantità di precipitazioni accumulate nell'ultima ora.

air_pressure

AirPressure

Le condizioni di pressione atmosferica attuali.

wind

Wind

Le condizioni attuali del vento.

visibility

Visibility

La visibilità attuale.

current_conditions_history

CurrentConditionsHistory

Le variazioni delle condizioni attuali nelle ultime 24 ore.

is_daytime

bool

True se l'ora corrente nella località richiesta è compresa tra l'alba locale (inclusa) e il tramonto (escluso). In caso contrario, è notte (tra il tramonto e l'alba successiva).

relative_humidity

int32

La percentuale attuale di umidità relativa (valori da 0 a 100).

uv_index

int32

L'attuale indice ultravioletto (UV).

thunderstorm_probability

int32

La probabilità attuale di temporale (valori da 0 a 100).

cloud_cover

int32

La percentuale attuale di cielo coperto da nuvole (valori da 0 a 100).

CurrentConditionsHistory

Rappresenta un insieme di modifiche alle condizioni attuali nelle ultime 24 ore.

Campi
temperature_change

Temperature

La temperatura attuale meno la temperatura di 24 ore prima.

max_temperature

Temperature

La temperatura massima (alta) nelle ultime 24 ore.

min_temperature

Temperature

La temperatura minima (bassa) nelle ultime 24 ore.

snow_qpf

QuantitativePrecipitationForecast

La quantità di neve, misurata come equivalente di acqua liquida, che si è accumulata nelle ultime 24 ore. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

La quantità di precipitazioni piovose, misurata come equivalente di acqua liquida, che si è accumulata nelle ultime 24 ore. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

LookupForecastDaysRequest

Richiesta per la RPC LookupForecastDays.

Campi
location

LatLng

Obbligatorio. La località per cui ricevere le previsioni giornaliere.

units_system

UnitsSystem

Facoltativo. Il sistema di unità da utilizzare per le condizioni meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).

page_size

int32

Facoltativo. Il numero massimo di record di previsione giornaliera da restituire per pagina, un valore compreso tra 1 e 10 (incluso). Il valore predefinito è 5.

page_token

string

Facoltativo. Un token di pagina ricevuto da una richiesta precedente. Viene utilizzato per recuperare la pagina successiva.

days

int32

Facoltativo. Limita la quantità di giorni totali da recuperare a partire dal giorno corrente. Il valore deve essere compreso tra 1 e 10 (inclusi). Il valore predefinito è il valore massimo consentito di 10.

language_code

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".

LookupForecastDaysResponse

Risposta per la RPC LookupForecastDays.

Campi
forecast_days[]

ForecastDay

I record delle previsioni giornaliere, in base al numero di giorni e alle dimensioni della pagina specificati nella richiesta.

time_zone

TimeZone

Il fuso orario nella posizione richiesta.

next_page_token

string

Il token per recuperare la pagina successiva.

LookupForecastHoursRequest

Richiesta della RPC LookupForecastHours.

Campi
location

LatLng

Obbligatorio. La località per cui ricevere le previsioni orarie.

units_system

UnitsSystem

Facoltativo. Il sistema di unità da utilizzare per le condizioni meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).

page_size

int32

Facoltativo. Il numero massimo di record di previsione oraria da restituire per pagina, un valore compreso tra 1 e 24 (incluso). Il valore predefinito è il valore massimo consentito di 24.

page_token

string

Facoltativo. Un token di pagina ricevuto da una richiesta precedente. Viene utilizzato per recuperare la pagina successiva.

hours

int32

Facoltativo. Limita la quantità di ore totali da recuperare a partire dall'ora corrente. Il valore deve essere compreso tra 1 e 240 (inclusi). Il valore predefinito è il valore massimo consentito di 240.

language_code

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".

LookupForecastHoursResponse

Risposta per la RPC LookupForecastHours.

Campi
forecast_hours[]

ForecastHour

I record delle previsioni orarie, in base al numero di ore e alle dimensioni della pagina specificati nella richiesta.

time_zone

TimeZone

Il fuso orario nella posizione richiesta.

next_page_token

string

Il token per recuperare la pagina successiva.

LookupHistoryHoursRequest

Richiesta della RPC LookupHistoryHours.

Campi
location

LatLng

Obbligatorio. La località per cui recuperare i dati orari storici.

units_system

UnitsSystem

Facoltativo. Il sistema di unità da utilizzare per le condizioni meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).

page_size

int32

Facoltativo. Il numero massimo di record storici orari da restituire per pagina: un valore compreso tra 1 e 24 (incluso). Il valore predefinito è il valore massimo consentito di 24.

page_token

string

Facoltativo. Un token di pagina ricevuto da una richiesta precedente. Viene utilizzato per recuperare la pagina successiva.

hours

int32

Facoltativo. Limita la quantità di ore totali da recuperare a partire dall'ultima ora, da 1 a 24 (incluso). Il valore predefinito è il valore massimo consentito di 24.

language_code

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".

LookupHistoryHoursResponse

Risposta per la RPC LookupHistoryHours.

Campi
history_hours[]

HistoryHour

I record storici orari, in base al numero di ore e alle dimensioni della pagina specificati nella richiesta.

time_zone

TimeZone

Il fuso orario nella posizione richiesta.

next_page_token

string

Il token per recuperare la pagina successiva.

LookupPublicAlertsRequest

Richiesta per la RPC LookupPublicAlerts.

Campi
location

LatLng

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

page_size

int32

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

page_token

string

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

language_code

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".

LookupPublicAlertsResponse

Risposta per la RPC LookupPublicAlerts.

Campi
weather_alerts[]

PublicAlerts

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

region_code

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.

next_page_token

string

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

MoonEvents

Rappresenta gli eventi relativi alla luna (ad es. sorgere della luna, tramonto della luna).

Campi
moonrise_times[]

Timestamp

Il momento in cui il bordo superiore della luna appare sopra l'orizzonte (vedi https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: nella maggior parte dei casi, ci sarà un solo orario di sorgere della luna al giorno. In altri casi, l'elenco potrebbe essere vuoto (ad es. quando la luna sorge dopo la mezzanotte del giorno successivo). Tuttavia, in casi unici (ad es. nelle regioni polari), l'elenco può contenere più di un valore. In questi casi, i valori vengono ordinati in ordine crescente.

moonset_times[]

Timestamp

Il momento in cui il lembo superiore della luna scompare sotto l'orizzonte (vedi https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: nella maggior parte dei casi, ci sarà un solo orario di tramonto della luna al giorno. In altri casi, l'elenco potrebbe essere vuoto (ad es. quando la luna tramonta dopo la mezzanotte del giorno successivo). Tuttavia, in casi unici (ad es. nelle regioni polari), l'elenco può contenere più di un valore. In questi casi, i valori vengono ordinati in ordine crescente.

moon_phase

MoonPhase

La fase lunare.

MoonPhase

Indica la fase lunare.

Enum
MOON_PHASE_UNSPECIFIED Fase lunare non specificata.
NEW_MOON La luna non è illuminata dal sole.
WAXING_CRESCENT La Luna è illuminata per il 0-50% sul lato destro nell'emisfero settentrionale 🌒 e sul lato sinistro nell'emisfero australe 🌘.
FIRST_QUARTER La Luna è illuminata al 50,1% sul lato destro nell'emisfero settentrionale 🌓 e sul lato sinistro nell'emisfero australe 🌗.
WAXING_GIBBOUS La Luna è illuminata al 50-100% sul lato destro nell'emisfero settentrionale 🌔 e sul lato sinistro nell'emisfero australe 🌖.
FULL_MOON La luna è completamente illuminata.
WANING_GIBBOUS La Luna è illuminata al 50-100% sul lato sinistro nell'emisfero settentrionale 🌖 e sul lato destro nell'emisfero australe 🌔.
LAST_QUARTER La Luna è illuminata al 50,1% sul lato sinistro nell'emisfero settentrionale 🌗 e sul lato destro nell'emisfero australe 🌓.
WANING_CRESCENT La Luna è illuminata al 0-50% sul lato sinistro nell'emisfero settentrionale 🌘 e sul lato destro nell'emisfero australe 🌒.

Precipitazioni

Rappresenta un insieme di valori di precipitazione in una determinata località.

Campi
probability

PrecipitationProbability

La probabilità di precipitazioni (valori da 0 a 100).

snow_qpf

QuantitativePrecipitationForecast

La quantità di neve, misurata come equivalente di acqua liquida, che si è accumulata in un determinato periodo di tempo. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

La quantità di pioggia precipitata, misurata come equivalente di acqua liquida, che si è accumulata in un determinato periodo di tempo. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

PrecipitationProbability

Rappresenta la probabilità di precipitazioni in una determinata località.

Campi
type

PrecipitationType

Un codice che indica il tipo di precipitazione.

percent

int32

Una percentuale compresa tra 0 e 100 che indica le probabilità di precipitazioni.

PrecipitationType

Rappresenta il tipo di precipitazione in una determinata località.

Enum
PRECIPITATION_TYPE_UNSPECIFIED Tipo di precipitazione non specificato.
NONE Nessuna precipitazione.
SNOW Precipitazioni nevose.
RAIN Precipitazioni di pioggia.
LIGHT_RAIN Precipitazioni di pioggia leggera.
HEAVY_RAIN Forti precipitazioni piovose.
RAIN_AND_SNOW Precipitazioni di pioggia e neve.
SLEET Precipitazioni di nevischio.
FREEZING_RAIN Precipitazioni di pioggia congelantesi.

PublicAlerts

Rappresenta le allerte meteo pubbliche.

Campi
alert_id

string

L'identificatore univoco di questo avviso.

alert_title

LocalizedText

Il titolo localizzato dell'avviso.

event_type

WeatherEventType

Il tipo di evento meteorologico.

area_name

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.

safety_recommendations[]

SafetyRecommendation

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

timezone_offset

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.

start_time

Timestamp

L'ora di inizio dell'evento.

expiration_time

Timestamp

L'ora di scadenza dell'evento.

data_source

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

Severity

Il livello di gravità dell'avviso.

certainty

Certainty

La certezza dell'avviso.

urgency

Urgency

L'urgenza dell'avviso.

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

QuantitativePrecipitationForecast

Rappresenta la quantità prevista di precipitazioni sciolte accumulate in un periodo di tempo specificato su un'area specificata (riferimento: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast), in genere abbreviato in QPF.

Campi
unit

Unit

Il codice dell'unità utilizzata per misurare la quantità di precipitazioni accumulate.

quantity

float

La quantità di precipitazioni, misurata come equivalente di acqua liquida, che si è accumulata in un determinato periodo di tempo.

Unità

Rappresenta l'unità utilizzata per misurare la quantità di precipitazioni accumulate.

Enum
UNIT_UNSPECIFIED Unità di precipitazione non specificata.
MILLIMETERS La quantità di precipitazioni viene misurata in millimetri.
INCHES La quantità di precipitazioni viene misurata in pollici.

SafetyRecommendation

Rappresenta un consiglio di sicurezza.

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.

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à.

SpeedUnit

Rappresenta l'unità utilizzata per misurare la velocità.

Enum
SPEED_UNIT_UNSPECIFIED L'unità di velocità non è specificata.
KILOMETERS_PER_HOUR La velocità è misurata in chilometri all'ora.
MILES_PER_HOUR La velocità è misurata in miglia all'ora.

SunEvents

Rappresenta gli eventi relativi al sole (ad es. alba, tramonto).

Campi
sunrise_time

Timestamp

L'ora in cui sorge il sole.

NOTA: in alcuni casi particolari (ad es. a nord del circolo polare artico) potrebbe non esserci l'ora dell'alba per un giorno. In questi casi, questo campo non verrà impostato.

sunset_time

Timestamp

L'ora in cui tramonta il sole.

NOTA: in alcuni casi unici (ad es. a nord del circolo polare artico) potrebbe non esserci un orario del tramonto per un giorno. In questi casi, questo campo non verrà impostato.

Temperatura

Rappresenta un valore di temperatura.

Campi
unit

TemperatureUnit

Il codice dell'unità utilizzata per misurare il valore della temperatura.

degrees

float

Il valore della temperatura (in gradi) nell'unità specificata.

TemperatureUnit

Rappresenta un'unità utilizzata per misurare le temperature.

Enum
TEMPERATURE_UNIT_UNSPECIFIED L'unità di temperatura non è specificata.
CELSIUS La temperatura è misurata in gradi Celsius.
FAHRENHEIT La temperatura è misurata in gradi Fahrenheit.

UnitsSystem

Rappresenta il sistema di unità di misura utilizzato per misurare i valori.

Enum
UNITS_SYSTEM_UNSPECIFIED Il sistema di unità non è specificato.
IMPERIAL Il sistema di unità imperiali (ad es. Fahrenheit, miglia e così via).
METRIC Il sistema di unità metriche (ad es. Celsius, chilometri e così via).

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.

Visibilità

Rappresenta le condizioni di visibilità, la distanza alla quale gli oggetti possono essere distinti.

Campi
unit

Unit

Il codice che rappresenta l'unità utilizzata per misurare la distanza.

distance

float

La distanza di visibilità nell'unità specificata.

Unità

Rappresenta l'unità utilizzata per misurare la distanza di visibilità.

Enum
UNIT_UNSPECIFIED L'unità di visibilità non è specificata.
KILOMETERS La visibilità è misurata in chilometri.
MILES La visibilità è misurata in miglia.

WeatherCondition

Rappresenta una condizione meteo per una determinata località in un determinato periodo di tempo.

Disclaimer: le icone meteo e i codici delle condizioni sono soggetti a modifiche. Google potrebbe introdurre nuovi codici e icone o aggiornare quelli esistenti in base alle esigenze. Ti consigliamo di consultare regolarmente questa documentazione per informazioni aggiornate.

Campi
icon_base_uri

string

L'URI di base per l'icona, senza l'estensione del tipo di file. Per visualizzare l'icona, aggiungi un tema, se vuoi, e l'estensione del tipo di file (.png o .svg) a questo URI. Per impostazione predefinita, l'icona ha un tema chiaro, ma è possibile aggiungere _dark per la modalità Buio. Ad esempio: "https://maps.gstatic.com/weather/v1/dust.svg" o "https://maps.gstatic.com/weather/v1/dust_dark.svg", dove icon_base_uri è "https://maps.gstatic.com/weather/v1/dust".

description

LocalizedText

La descrizione testuale di questa condizione meteo (localizzata).

type

Type

Il tipo di condizione meteorologica.

Tipo

Indica il tipo di condizione meteo nel contesto di un elemento di previsione.

Enum
TYPE_UNSPECIFIED La condizione meteo non è specificata.
CLEAR Nessuna nuvola.
MOSTLY_CLEAR Nuvolosità intermittente.
PARTLY_CLOUDY Parzialmente nuvoloso (alcune nuvole).
MOSTLY_CLOUDY Prevalentemente nuvoloso (più nuvole che sole).
CLOUDY Nuvoloso (tutte le nuvole, senza sole).
WINDY Vento forte.
WIND_AND_RAIN Vento forte con precipitazioni.
LIGHT_RAIN_SHOWERS Pioggia debole intermittente.
CHANCE_OF_SHOWERS Possibilità di pioggia intermittente.
SCATTERED_SHOWERS Pioggia intermittente.
RAIN_SHOWERS I rovesci sono considerati precipitazioni di durata inferiore rispetto alla pioggia e sono caratterizzati da inizio e fine improvvisi e da rapidi cambiamenti di intensità.
HEAVY_RAIN_SHOWERS Rovesci intensi.
LIGHT_TO_MODERATE_RAIN Pioggia (da leggera a moderata).
MODERATE_TO_HEAVY_RAIN Pioggia (da moderata a intensa).
RAIN Pioggia moderata.
LIGHT_RAIN Pioggia leggera.
HEAVY_RAIN Forte pioggia.
RAIN_PERIODICALLY_HEAVY Pioggia a tratti intensa.
LIGHT_SNOW_SHOWERS Neve leggera che cade a intensità variabile per brevi periodi di tempo.
CHANCE_OF_SNOW_SHOWERS Possibili rovesci a carattere nevoso.
SCATTERED_SNOW_SHOWERS Neve che cade a intensità variabile per brevi periodi di tempo.
SNOW_SHOWERS Rovesci nevosi.
HEAVY_SNOW_SHOWERS Forti rovesci nevosi.
LIGHT_TO_MODERATE_SNOW Neve da leggera a moderata.
MODERATE_TO_HEAVY_SNOW Neve da moderata a intensa.
SNOW Neve moderata.
LIGHT_SNOW Nevicate leggere.
HEAVY_SNOW Forti nevicate.
SNOWSTORM Neve con possibili tuoni e fulmini.
SNOW_PERIODICALLY_HEAVY Neve, a tratti intensa.
HEAVY_SNOW_STORM Forti nevicate con possibili tuoni e fulmini.
BLOWING_SNOW Neve con vento forte.
RAIN_AND_SNOW Pioggia mista a neve.
HAIL Grandine.
HAIL_SHOWERS Grandine che cade a intensità variabile per brevi periodi di tempo.
THUNDERSTORM Temporale.
THUNDERSHOWER Un acquazzone accompagnato da tuoni e fulmini.
LIGHT_THUNDERSTORM_RAIN Debole temporale a carattere piovoso.
SCATTERED_THUNDERSTORMS Temporali con pioggia di varia intensità per brevi periodi di tempo.
HEAVY_THUNDERSTORM Forte temporale.

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.

Wind

Rappresenta un insieme di proprietà del vento.

Campi
direction

WindDirection

La direzione del vento, l'angolo da cui proviene.

speed

WindSpeed

La velocità del vento.

gust

WindSpeed

La raffica di vento (aumento improvviso della velocità del vento).

WindDirection

Rappresenta la direzione da cui proviene il vento.

Campi
cardinal

CardinalDirection

Il codice che rappresenta la direzione cardinale da cui soffia il vento.

degrees

int32

La direzione del vento in gradi (valori da 0 a 360).

WindSpeed

Rappresenta la velocità del vento.

Campi
unit

SpeedUnit

Il codice che rappresenta l'unità utilizzata per misurare la velocità del vento.

value

float

Il valore della velocità del vento.