MCP Tools Reference: mapstools.googleapis.com

Strumento: lookup_weather

Recupera informazioni ambientali complete per una località, tra cui meteo, qualità dell'aria (AQI e inquinanti) e polline (livelli di allergeni di alberi, erba, piante infestanti e specie vegetali): condizioni attuali, previsioni/cronologia orarie e previsioni giornaliere per meteo e qualità dell'aria; per il polline è disponibile solo una previsione giornaliera (da oggi a +4 giorni, nessun dato orario o passato). Available Environmental Domains & Capabilities (capabilities: WEATHER, AIR_QUALITY, POLLEN — CRITICAL): * Mandatory Explicit Selection: You MUST include at least one of WEATHER, AIR_QUALITY, or POLLEN in capabilities on every call. L'omissione di capabilities NON è consentita. * Query generiche/ambigue sull'outdoor (suite completa per l'outdoor): se l'utente pone una domanda generale sull'outdoor, sui viaggi o sulla situazione senza limitarsi a un dominio specifico (ad es. "Com'è il tempo fuori per una corsa?"), includi esplicitamente tutte e tre le funzionalità (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) per restituire la suite completa per l'outdoor (meteo + qualità dell'aria + polline); per un date/hour passato, ometti POLLEN, che non ha cronologia. * Selezione del dominio mirato (query specifiche): se l'utente chiede specificamente solo uno o due domini (ad es. "Qual è l'AQI a Seattle in questo momento?"), includi solo le funzionalità richieste (WEATHER, AIR_QUALITY e/o POLLEN). Verranno eseguiti e restituiti solo i domini richiesti. Dati specifici disponibili per dominio: * Meteo (weather): temperatura (attuale, percepita, massima/minima, indice di calore), vento (velocità, raffiche, direzione), eventi celesti (alba/tramonto, fase lunare), precipitazioni (tipo, probabilità, quantità/QPF) e condizioni atmosferiche (indice UV, umidità, copertura nuvolosa, probabilità di temporali, pressione atmosferica). * Qualità dell'aria (air_quality): indici di qualità dell'aria universali e locali (valore IQA, categoria, inquinante dominante), consigli per la salute in 7 gruppi di sensibilità e concentrazioni di inquinanti (include_pollutant_concentration: true). Ogni indice ha il proprio inquinante dominante; segnalalo per indice (ad es. non fornire l'inquinante dell'IQA universale per l'IQA degli Stati Uniti). * Polline (pollen): indice UPI (Universal Pollen Index, 0-5) giornaliero per le categorie Alberi, Erba ed Erbe infestanti e per specie di piante (index.value con il relativo index.category, ad esempio 1 = "Molto basso"), stato stagionale, reazioni crociate e consigli per la salute. * Campi dei pollini mancanti: un valore in_season mancante indica che non è stagione. Ometti le specie di piante restituite senza un index, a meno che l'utente non chieda informazioni su quella pianta; in questo caso, di' che oggi non sono stati segnalati dati sui pollini per quella pianta (non dedurre un livello). Regole per la località (CRITICO): la località target DEVE essere specificata in location utilizzando SOLO UNO dei seguenti campi secondari oneof: 1. Coordinate geografiche (lat_lng): * Utilizza questa opzione quando sono note le coordinate esatte di latitudine/longitudine. * Esempio: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. ID luogo (place_id): * Un ID luogo di Google Maps univoco (ad esempio, ottenuto da search_places o resolve_names). * Esempio: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Stringa dell'indirizzo (address): * Una città/regione, un quartiere, un punto di riferimento o un punto d'interesse, un indirizzo o un codice postale, idealmente con la città/il paese. * Esempio: {"location": {"address": "Paris, France"}} Modalità di ora e utilizzo (date e hour - CRITICO): * Riferimento al fuso orario locale: tutti gli input date ({year, month, day}) e hour (0-23) DEVONO essere espressi nel fuso orario civile locale della location richiesta (ad es. una query per "Paris tomorrow at 13:00" utilizza la data e l'ora locali di Europe/Paris 13), mai UTC o il fuso orario del chiamante. * 1. Current Conditions (date omitted AND hour omitted): * Provide location and the target capabilities (WEATHER, AIR_QUALITY, POLLEN). Do NOT specify date or hour. * Restituisce le condizioni attuali in tempo reale (CC) per i domini richiesti (meteo attuale, qualità dell'aria dell'ora corrente e/o previsioni dei pollini di oggi). * Per la qualità dell'aria, le condizioni attuali si riferiscono a una singola ora: NON utilizzarle da sole per rispondere a domande sulla qualità dell'aria o su domande generiche relative all'aria aperta per oggi nel suo complesso (utilizza le query giornaliere di seguito). * 2. Previsioni/cronologia orarie (date specificato E hour specificato 0-23): * Fornisci location, date ({year, month, day}), hour (0-23) e il target capabilities. Se vengono menzionati i minuti, arrotonda per difetto all'ora più vicina. * VINCOLO CRITICO (date è OBBLIGATORIO quando è impostato hour): l'invio di hour senza date (date omesso, hour impostato) NON è consentito e genererà un errore. Anche se l'utente chiede informazioni su un'ora specifica di oggi (ad es. "at 13:00 today"), DEVI compilare sia date (la data di oggi alle location) sia hour. * Esegue una ricerca oraria per il meteo e/o la qualità dell'aria richiesti alle ore YYYY-MM-DD-HH e una ricerca giornaliera per i pollini richiesti il giorno YYYY-MM-DD. * Domande sul meteo con "quando": per le domande sul meteo che chiedono quando/a che ora/il momento migliore (ad es. "what time will it stop raining?"), utilizza le chiamate WEATHER orarie (date + hour) per le ore pertinenti. Una previsione meteo giornaliera non ha valori orari. Per domande generiche sulle attività all'aperto con "quando/momento migliore" (ad es. "when is the best time to go walking today?"), effettua queste chiamate WEATHER orarie oltre alla chiamata per l'intera giornata per la qualità dell'aria (e il polline) descritta in Query giornaliere. * 3. Query giornaliere (date specificato E hour omesso): * Fornisci location, date ({year, month, day} nell'ora civile locale di location richiesta) senza hour e capabilities target per le query di un'intera giornata (ad es. "weather and pollen in London tomorrow"). * Domande sulla qualità dell'aria e domande generiche sull'outdoor relative a oggi: per le domande sulla qualità dell'aria e le domande generiche sull'outdoor (che includono la qualità dell'aria) relative a oggi (ad es. "how will the air quality change today", "is today a good day for a picnic?"), imposta date sulla data odierna alle ore location (ora omessa) per ottenere la serie oraria della qualità dell'aria del giorno. Una chiamata Current Conditions da sola restituisce solo l'ora corrente della qualità dell'aria e non è sufficiente; puoi aggiungerne una se l'utente chiede anche informazioni su "ora". * Finestre temporali della qualità dell'aria: per una domanda sulla qualità dell'aria relativa a una finestra temporale di un giorno (ad es. "air quality between noon and 6 PM"), preferisci una chiamata giornaliera per quella data e leggi le ore della finestra temporale dalla serie della qualità dell'aria, anziché campionare le singole ore. Se utilizzi le chiamate orarie, copri ogni ora della finestra. * Restituisce le previsioni giornaliere per Meteo e/o Polline richiesti e le serie orarie di Qualità dell'aria del giorno che coprono l'intera giornata locale (00:00-23:00 ora locale): 24 ore storiche per una data passata, 24 ore previste per una data futura e per oggi le ore precedenti (cronologia), l'ora corrente e le ore rimanenti (previsione). Orizzonti temporali supportati per dominio: * Meteo: ogni ora dalle 24 ore precedenti fino alle 240 ore (10 giorni) successive (le ore precedenti richiedono sia date che hour); ogni giorno fino a 10 giorni, incluso oggi (da oggi a +9 giorni); nessuna cronologia giornaliera. * Qualità dell'aria: ogni ora da 720 ore (30 giorni) fa fino a 96 ore (4 giorni) in avanti; una chiamata per l'intera giornata deve rientrare in questa finestra (in pratica oggi da -29 giorni a +3 giorni). * Polline: solo giornaliero, da oggi a +4 giorni (5 giorni incluso oggi); nessuna data passata e hour viene ignorato. * (Nota: se vengono richieste più funzionalità e date/hour non rientra in uno dei relativi intervalli, la chiamata viene comunque eseguita correttamente e restituisce solo quelle supportate.) * Richieste fuori intervallo: se una data o un'ora richiesta potrebbe non rientrare nell'intervallo supportato di un dominio (ad esempio, Pollen per una data passata), chiama comunque lookup_weather per la data/ora richiesta; lo stato di errore indica l'intervallo supportato. Non chiamare una data, un'ora o un dominio diversi come sostituti. Opzioni di dominio e attribuzione: * Lingua (language_code): codice lingua BCP-47 facoltativo (ad es. "fr"). Il valore predefinito è "en". * Unità meteo (weather_options.units_system o units_system): il valore predefinito è METRIC. Imposta su IMPERIAL (Fahrenheit/mph) se l'utente fa riferimento agli standard statunitensi o richiede esplicitamente le unità imperiali. Supportato sia in weather_options.units_system (preferito) sia in units_system di primo livello; se vengono specificati entrambi, non devono essere in conflitto. * Opzioni di qualità dell'aria (air_quality_options): imposta include_pollutant_concentration: true quando sono necessarie concentrazioni di inquinanti specifiche (PM2.5, PM10, O3, NO2, SO2, CO); facoltativamente imposta index_region_code (codice paese ISO di 2 lettere, ad es. "US") per richiedere una scala AQI regionale specifica. Per impostazione predefinita, la risposta include l'IQA universale e l'IQA regionale della località. * Attribuzione: l'output basato su dati reali DEVE essere attribuito alla fonte utilizzando il campo attribution all'interno di ogni container di dominio restituito (weather.attribution, air_quality.attribution, pollen.attribution). * Orari restituiti: i valori date_time della qualità dell'aria sono già nell'ora locale della località (utc_offset incluso); presentali così come sono. I valori date_time del meteo (corrente e orario) e gli orari di alba/tramonto sono in formato UTC; convertili nell'ora locale della località utilizzando time_zone. Etichetta tutti gli orari come locali.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP lookup_weather.

Richiesta curl
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta per il metodo LookupWeather: rappresenta le condizioni meteo nella località richiesta.

LookupWeatherRequest

Rappresentazione JSON
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
Campi
unitsSystem

enum (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).

location

object (Location)

Obbligatorio. La località per cui ottenere le condizioni meteo.

capabilities[]

enum (Capability)

Facoltativo. Le funzionalità ambientali da includere nella risposta.

Campo unione _date.

_date può essere solo uno dei seguenti tipi:

date

object (Date)

Facoltativo. Specifica la data delle informazioni ambientali richieste, in base al fuso orario locale della località specificata nel campo location. Gli intervalli di date supportati dipendono dalle funzionalità richieste: - WEATHER: fino a 24 ore nel passato (se è impostato anche hour) e fino a 10 giorni (240 ore) nel futuro (da oggi a +9 giorni per le previsioni giornaliere). - AIR_QUALITY: fino a 30 giorni (720 ore) nel passato e fino a 4 giorni (96 ore) nel futuro. - POLLEN: da oggi a +4 giorni (fino a 5 giorni, incluso oggi; le date storiche non sono supportate).

Campo unione _hour.

_hour può essere solo uno dei seguenti tipi:

hour

integer

Facoltativo. Specifica l'ora delle informazioni ambientali richieste, nel formato 24 ore (0-23), in base al fuso orario locale della località specificata nel campo location. Richiede che sia specificato date. Gli intervalli orari supportati dipendono dalle funzionalità richieste: - WEATHER: fino a 24 ore nel passato e fino a 240 ore (10 giorni) nel futuro. - AIR_QUALITY: fino a 30 giorni (720 ore) nel passato e fino a 4 giorni (96 ore) nel futuro. - POLLEN: restituisce solo le previsioni giornaliere; hour viene ignorato per i pollini.

Campo unione _language_code.

_language_code può essere solo uno dei seguenti tipi:

languageCode

string

Facoltativo. Il codice lingua BCP-47 per il testo localizzato nella risposta (ad es. "en", "ja", "fr-CA"). Se non specificato, il valore predefinito è "en".

Campo unione _weather_options.

_weather_options può essere solo uno dei seguenti tipi:

weatherOptions

object (WeatherOptions)

Facoltativo. Opzioni specifiche per le richieste relative al meteo. weather_options.units_system è supportato in combinazione con units_system di primo livello (tag 4) per preservare la compatibilità con le versioni precedenti per i chiamanti esistenti; restituisce INVALID_ARGUMENT se entrambi specificano sistemi di unità in conflitto. Ignorato se WEATHER non è richiesto in capabilities.

Campo unione _air_quality_options.

_air_quality_options può essere solo uno dei seguenti tipi:

airQualityOptions

object (AirQualityOptions)

Facoltativo. Opzioni specifiche per le richieste relative alla qualità dell'aria. Ignorato se AIR_QUALITY non è richiesto in capabilities.

Data

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere un valore compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

Località

Rappresentazione JSON
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campi
Campo unione location_type. Diversi modi per rappresentare una località. location_type può essere solo uno dei seguenti tipi:
latLng

object (LatLng)

Un punto specificato utilizzando le coordinate geografiche.

placeId

string

L'ID luogo associato alla località.

address

string

Indirizzo leggibile (ad es. via, città o codice postale).

LatLng

Rappresentazione JSON
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].

longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

WeatherOptions

Rappresentazione JSON
{
  "unitsSystem": enum (UnitsSystem)
}
Campi
unitsSystem

enum (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).

AirQualityOptions

Rappresentazione JSON
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Campi

Campo unione _include_pollutant_concentration.

_include_pollutant_concentration può essere solo uno dei seguenti tipi:

includePollutantConcentration

boolean

Facoltativo. Se impostato su true, include concentrazioni dettagliate degli agenti inquinanti e informazioni aggiuntive (cause ed effetti) nella risposta sulla qualità dell'aria.

Campo unione _index_region_code.

_index_region_code può essere solo uno dei seguenti tipi:

indexRegionCode

string

Facoltativo. Codice paese/regione ISO 3166-1 alpha-2 di due lettere (ad es. "US", "FR", "CN") utilizzato per selezionare la scala dell'indice di qualità dell'aria (IQA) locale preferita insieme all'IQA universale (UAQI). Se non specificato, il valore predefinito è la regione della località richiesta.

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

Capacità

Funzionalità ambientali che possono essere richieste in LookupWeatherRequest.

Enum
CAPABILITY_UNSPECIFIED Funzionalità non specificata.
WEATHER Condizioni meteorologiche (temperatura, precipitazioni, vento, UV e così via).
AIR_QUALITY Informazioni sulla qualità dell'aria (IQA, agenti inquinanti e consigli per la salute).
POLLEN Informazioni sui pollini (livelli di allergeni di alberi, erba, erbe infestanti e specie di piante).

Schema di output

Risposta per l'RPC LookupWeather: rappresenta le condizioni meteo nella località richiesta.

Questa risposta rappresenta informazioni sia orarie che giornaliere, pertanto è suddivisa in tre sezioni: Hourly, Daily e Shared. I campi Only-Hourly e Only-Daily sono contrassegnati come facoltativi. Per i campi condivisi tra le informazioni orarie e giornaliere, alcuni sono sempre presenti, quindi non sono contrassegnati come facoltativi, mentre gli altri sono contrassegnati come facoltativi perché non sono sempre disponibili.

LookupWeatherResponse

Rappresentazione JSON
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
Campi
weatherCondition

object (WeatherCondition)

La condizione meteo

precipitation

object (Precipitation)

La probabilità di precipitazioni e la quantità di precipitazioni accumulate

wind

object (Wind)

Le condizioni del vento

returnedLocation

object (Location)

Obbligatorio. La località per cui vengono restituite le informazioni meteo. Questa località è identica a quella della richiesta, ma può essere diversa se la località richiesta è un indirizzo di testo libero che rimanda a una posizione approssimativa (ad es. "Mountain View, CA").

attribution

object (Attribution)

Attribuzione obbligatoria da mostrare con il meteo.

Campo unione _temperature.

_temperature può essere solo uno dei seguenti tipi:

temperature

object (Temperature)

La temperatura oraria

Campo unione _feels_like_temperature.

_feels_like_temperature può essere solo uno dei seguenti tipi:

feelsLikeTemperature

object (Temperature)

La misurazione oraria della temperatura percepita.

Campo unione _heat_index.

_heat_index può essere solo uno dei seguenti tipi:

heatIndex

object (Temperature)

La temperatura dell'indice di calore orario.

Campo unione _air_pressure.

_air_pressure può essere solo uno dei seguenti tipi:

airPressure

object (AirPressure)

Le condizioni della pressione atmosferica oraria.

Campo unione _max_temperature.

_max_temperature può essere solo uno dei seguenti tipi:

maxTemperature

object (Temperature)

La temperatura massima (alta) durante il giorno.

Campo unione _min_temperature.

_min_temperature può essere solo uno dei seguenti tipi:

minTemperature

object (Temperature)

La temperatura minima (bassa) durante il giorno.

Campo unione _feels_like_max_temperature.

_feels_like_max_temperature può essere solo uno dei seguenti tipi:

feelsLikeMaxTemperature

object (Temperature)

La temperatura percepita massima (alta) nel corso della giornata.

Campo unione _feels_like_min_temperature.

_feels_like_min_temperature può essere solo uno dei seguenti tipi:

feelsLikeMinTemperature

object (Temperature)

La temperatura percepita minima (bassa) nel corso della giornata.

Campo unione _max_heat_index.

_max_heat_index può essere solo uno dei seguenti tipi:

maxHeatIndex

object (Temperature)

La temperatura massima dell'indice di calore durante il giorno.

Campo unione _sun_events.

_sun_events può essere solo uno dei seguenti tipi:

sunEvents

object (SunEvents)

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

Campo unione _moon_events.

_moon_events può essere solo uno dei seguenti tipi:

moonEvents

object (MoonEvents)

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

Campo unione _relative_humidity.

_relative_humidity può essere solo uno dei seguenti tipi:

relativeHumidity

integer

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

Campo unione _uv_index.

_uv_index può essere solo uno dei seguenti tipi:

uvIndex

integer

L'indice UV (ultravioletti) massimo.

Campo unione _thunderstorm_probability.

_thunderstorm_probability può essere solo uno dei seguenti tipi:

thunderstormProbability

integer

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

Campo unione _cloud_cover.

_cloud_cover può essere solo uno dei seguenti tipi:

cloudCover

integer

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

Campo unione _weather.

_weather può essere solo uno dei seguenti tipi:

weather

object (WeatherResultData)

Condizioni meteo nella località richiesta.

Campo unione _air_quality.

_air_quality può essere solo uno dei seguenti tipi:

airQuality

object (AirQualityResultData)

Informazioni sulla qualità dell'aria nella località richiesta.

Campo unione _pollen.

_pollen può essere solo uno dei seguenti tipi:

pollen

object (PollenResultData)

Informazioni sui pollini nella località richiesta.

Campo unione _time_zone.

_time_zone può essere solo uno dei seguenti tipi:

timeZone

string

Stringa del fuso orario IANA risolta per la località (ad es. "America/New_York", "Asia/Tokyo").

Temperatura

Rappresentazione JSON
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Campi
unit

enum (Unit)

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

Campo unione _degrees.

_degrees può essere solo uno dei seguenti tipi:

degrees

number

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

AirPressure

Rappresentazione JSON
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Campi

Campo unione _mean_sea_level_millibars.

_mean_sea_level_millibars può essere solo uno dei seguenti tipi:

meanSeaLevelMillibars

number

La pressione atmosferica media a livello del mare in millibar.

SunEvents

Rappresentazione JSON
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campi
sunriseTime

string (Timestamp format)

L'ora in cui sorge il sole.

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

sunsetTime

string (Timestamp format)

L'ora in cui tramonta il sole.

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

Timestamp

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrispondono a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).

nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere un valore compreso tra 0 e 999.999.999 inclusi.

MoonEvents

Rappresentazione JSON
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
Campi
moonPhase

enum (Phase)

Facoltativo. La fase lunare.

moonriseTimes[]

string (Timestamp format)

L'ora in cui il lembo 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 esempio, quando la luna sorge dopo la mezzanotte del giorno successivo). Tuttavia, in casi unici (ad es. nelle regioni polari), l'elenco potrebbe contenere più di un valore. In questi casi, i valori vengono ordinati in ordine crescente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

moonsetTimes[]

string (Timestamp format)

L'ora in cui il bordo 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 esempio, quando la luna tramonta dopo la mezzanotte del giorno successivo). Tuttavia, in casi unici (ad es. nelle regioni polari), l'elenco potrebbe contenere più di un valore. In questi casi, i valori vengono ordinati in ordine crescente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

WeatherCondition

Rappresentazione JSON
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Campi
iconBaseUri

string

L'URI di base dell'icona, esclusa 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

object (LocalizedText)

La descrizione testuale di questa condizione meteo (localizzata).

type

enum (Type)

Il tipo di condizione meteo.

LocalizedText

Rappresentazione JSON
{
  "text": string,
  "languageCode": string
}
Campi
text

string

Stringa localizzata nella lingua corrispondente a google.type.LocalizedText.language_code di seguito.

languageCode

string

Il codice lingua BCP-47 del testo, ad esempio "en-US" o "sr-Latn".

Per saperne di più, consulta la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Precipitazioni

Rappresentazione JSON
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campi
probability

object (PrecipitationProbability)

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

snowQpf

object (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 Quantitative Precipitation Forecast (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

qpf

object (QuantitativePrecipitationForecast)

La quantità di precipitazioni piovose, misurata come equivalente di acqua liquida, accumulata in un determinato periodo di tempo. Nota: QPF è l'abbreviazione di Quantitative Precipitation Forecast (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

PrecipitationProbability

Rappresentazione JSON
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Campi
type

enum (Type)

Facoltativo. Un codice che indica il tipo di precipitazione.

Campo unione _percent.

_percent può essere solo uno dei seguenti tipi:

percent

integer

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

QuantitativePrecipitationForecast

Rappresentazione JSON
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Campi
unit

enum (Unit)

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

Campo unione _quantity.

_quantity può essere solo uno dei seguenti tipi:

quantity

number

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

Wind

Rappresentazione JSON
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Campi
direction

object (WindDirection)

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

speed

object (WindSpeed)

La velocità del vento.

gust

object (WindSpeed)

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

WindDirection

Rappresentazione JSON
{
  "cardinal": enum (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Campi
cardinal

enum (Cardinal)

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

Campo unione _degrees.

_degrees può essere solo uno dei seguenti tipi:

degrees

integer

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

WindSpeed

Rappresentazione JSON
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campi
unit

enum (Unit)

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

Campo unione _value.

_value può essere solo uno dei seguenti tipi:

value

number

Il valore della velocità del vento.

Località

Rappresentazione JSON
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campi
Campo unione location_type. Diversi modi per rappresentare una località. location_type può essere solo uno dei seguenti tipi:
latLng

object (LatLng)

Un punto specificato utilizzando le coordinate geografiche.

placeId

string

L'ID luogo associato alla località.

address

string

Indirizzo leggibile (ad es. via, città o codice postale).

LatLng

Rappresentazione JSON
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].

longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

Attribuzione

Rappresentazione JSON
{
  "title": string,
  "url": string
}
Campi
title

string

Il titolo da visualizzare per l'attribuzione.

url

string

L'URL a cui collegare l'attribuzione.

WeatherResultData

Rappresentazione JSON
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Campi
weatherCondition

object (WeatherCondition)

La condizione meteo.

precipitation

object (Precipitation)

La probabilità di precipitazioni e la quantità di precipitazioni accumulate.

wind

object (Wind)

Le condizioni del vento.

attribution

object (Attribution)

Attribuzione obbligatoria da mostrare con il meteo.

Campo unione _date_time.

_date_time può essere solo uno dei seguenti tipi:

dateTime

string (Timestamp format)

Il timestamp di questa voce meteo oraria o attuale.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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".

Campo unione _temperature.

_temperature può essere solo uno dei seguenti tipi:

temperature

object (Temperature)

La temperatura oraria.

Campo unione _feels_like_temperature.

_feels_like_temperature può essere solo uno dei seguenti tipi:

feelsLikeTemperature

object (Temperature)

La misurazione oraria della temperatura percepita.

Campo unione _heat_index.

_heat_index può essere solo uno dei seguenti tipi:

heatIndex

object (Temperature)

La temperatura dell'indice di calore orario.

Campo unione _air_pressure.

_air_pressure può essere solo uno dei seguenti tipi:

airPressure

object (AirPressure)

Le condizioni della pressione atmosferica oraria.

Campo unione _date.

_date può essere solo uno dei seguenti tipi:

date

object (Date)

Data del calendario civile delle previsioni meteo giornaliere.

Campo unione _max_temperature.

_max_temperature può essere solo uno dei seguenti tipi:

maxTemperature

object (Temperature)

La temperatura massima (alta) durante il giorno.

Campo unione _min_temperature.

_min_temperature può essere solo uno dei seguenti tipi:

minTemperature

object (Temperature)

La temperatura minima (bassa) durante il giorno.

Campo unione _feels_like_max_temperature.

_feels_like_max_temperature può essere solo uno dei seguenti tipi:

feelsLikeMaxTemperature

object (Temperature)

La temperatura percepita massima (alta) nel corso della giornata.

Campo unione _feels_like_min_temperature.

_feels_like_min_temperature può essere solo uno dei seguenti tipi:

feelsLikeMinTemperature

object (Temperature)

La temperatura percepita minima (bassa) nel corso della giornata.

Campo unione _max_heat_index.

_max_heat_index può essere solo uno dei seguenti tipi:

maxHeatIndex

object (Temperature)

La temperatura massima dell'indice di calore durante il giorno.

Campo unione _sun_events.

_sun_events può essere solo uno dei seguenti tipi:

sunEvents

object (SunEvents)

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

Campo unione _moon_events.

_moon_events può essere solo uno dei seguenti tipi:

moonEvents

object (MoonEvents)

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

Campo unione _relative_humidity.

_relative_humidity può essere solo uno dei seguenti tipi:

relativeHumidity

integer

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

Campo unione _uv_index.

_uv_index può essere solo uno dei seguenti tipi:

uvIndex

integer

L'indice UV (ultravioletti) massimo.

Campo unione _thunderstorm_probability.

_thunderstorm_probability può essere solo uno dei seguenti tipi:

thunderstormProbability

integer

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

Campo unione _cloud_cover.

_cloud_cover può essere solo uno dei seguenti tipi:

cloudCover

integer

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

Data

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere un valore compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

AirQualityResultData

Rappresentazione JSON
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Campi
hourlyResults[]

object (AirQualityHourlyResult)

Dati orari sulla qualità dell'aria per l'ora richiesta (contiene 1 voce per le condizioni attuali o le query di una singola ora, fino a 24 voci per una query di sola data passata o futura o le ore attuali + rimanenti quando la data è oggi).

attribution

object (Attribution)

Attribuzione obbligatoria da mostrare con i dati sulla qualità dell'aria.

AirQualityHourlyResult

Rappresentazione JSON
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Campi
indexes[]

object (AirQualityIndex)

Indici di qualità dell'aria (ad es. AQI universale e AQI locale).

pollutants[]

object (Pollutant)

Informazioni dettagliate sugli agenti inquinanti, compilate quando air_quality_options.include_pollutant_concentration è true.

healthRecommendations

object (HealthRecommendations)

Consigli per la salute per diversi gruppi di popolazione.

dateTime

object (DateTime)

La data e l'ora locali nel fuso orario della località per questa voce oraria sulla qualità dell'aria (composta da year, month, day, hours, minutes, seconds e utc_offset).

AirQualityIndex

Rappresentazione JSON
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campi
displayName

string

Il nome visualizzato dell'indice (ad es. "AQI universale", "AQI US EPA").

valueDisplay

string

Rappresentazione della stringa formattata del valore AQI.

category

string

Categoria di qualità dell'aria testuale (ad es. "Qualità dell'aria buona", "Qualità dell'aria media").

dominantPollutant

string

Il codice dell'agente inquinante dominante (ad es. "pm25", "o3").

Campo unione _value.

_value può essere solo uno dei seguenti tipi:

value

integer

Valore numerico dell'IQA.

Inquinante

Rappresentazione JSON
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Campi
displayName

string

Nome visualizzato breve dell'agente inquinante (ad es. "PM2.5", "O3").

fullName

string

Nome chimico o comune completo dell'agente inquinante (ad es. "Particolato sottile (< 2,5 µm)", "Ozono").

concentration

object (Concentration)

Concentrazione misurata dell'inquinante.

additionalInfo

object (AdditionalInfo)

Informazioni aggiuntive sulle fonti dell'agente inquinante e sui suoi effetti sulla salute.

Concentrazione

Rappresentazione JSON
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campi
unit

enum (Unit)

Unità di misura della concentrazione.

Campo unione _value.

_value può essere solo uno dei seguenti tipi:

value

number

Valore numerico della concentrazione.

AdditionalInfo

Rappresentazione JSON
{
  "sources": string,
  "effects": string
}
Campi
sources

string

Principali fonti di emissione dell'agente inquinante.

effects

string

Potenziali effetti sulla salute dell'esposizione all'inquinante.

HealthRecommendations

Rappresentazione JSON
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Campi
generalPopulation

string

Indicazioni per la popolazione generale.

elderly

string

Indicazioni per la popolazione anziana.

lungDiseasePopulation

string

Indicazioni per le persone con malattie polmonari o patologie respiratorie.

heartDiseasePopulation

string

Indicazioni per le persone con malattie cardiovascolari o cardiache.

athletes

string

Indicazioni per atleti e persone che praticano attività all'aperto.

pregnantWomen

string

Indicazioni per le donne in gravidanza.

children

string

Supervisione dei genitori.

DateTime

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Campi
year

integer

Facoltativo. Anno della data. Deve essere un valore compreso tra 1 e 9999 oppure 0 se specifichi una data e ora senza anno.

month

integer

Facoltativo. Mese dell'anno. Deve essere compreso tra 1 e 12 o pari a 0 se specifichi una data e ora senza mese.

day

integer

Facoltativo. Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 se specifichi un valore datetime senza un giorno.

hours

integer

Facoltativo. Ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23, il valore predefinito è 0 (mezzanotte). Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura di un'attività.

minutes

integer

Facoltativo. Minuti dell'ora del giorno. Deve essere compreso tra 0 e 59, il valore predefinito è 0.

seconds

integer

Facoltativo. Secondi dei minuti dell'ora. In genere deve essere compreso tra 0 e 59, il valore predefinito è 0. Un'API può consentire il valore 60 se consente i secondi intercalari.

nanos

integer

Facoltativo. Frazioni di secondi in nanosecondi. Deve essere compreso tra 0 e 999.999.999; il valore predefinito è 0.

Campo unione time_offset. Facoltativo. Specifica l'offset UTC o il fuso orario di DateTime. Scegli con attenzione tra i due, considerando che i dati sul fuso orario potrebbero cambiare in futuro (ad esempio, un paese modifica le date di inizio/fine dell'ora legale e i valori DateTime futuri nell'intervallo interessato erano già stati memorizzati). Se omesso, il valore DateTime viene considerato nell'ora locale. time_offset può essere solo uno dei seguenti tipi:
utcOffset

string (Duration format)

Offset UTC. Deve essere un numero intero di secondi, compreso tra -18 ore e +18 ore. Ad esempio, un offset UTC di -4:00 verrebbe rappresentato come { seconds: -14400 }.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

timeZone

object (TimeZone)

Fuso orario.

Durata

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi con segno dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati da: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni

nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

TimeZone

Rappresentazione JSON
{
  "id": string,
  "version": string
}
Campi
id

string

Fuso orario del database dei fusi orari IANA. Ad esempio "America/New_York".

version

string

Facoltativo. Numero di versione del database dei fusi orari IANA. Ad esempio, "2019a".

PollenResultData

Rappresentazione JSON
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Campi
dailyForecast

object (DailyPollenForecast)

Previsione giornaliera della concentrazione di pollini per la data richiesta.

attribution

object (Attribution)

Attribuzione obbligatoria da mostrare con i dati sui pollini.

DailyPollenForecast

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Campi
date

object (Date)

Data del calendario civile della previsione.

categories[]

object (PollenCategoryInfo)

Suddivisione delle categorie generali di polline (alberi, graminacee, erbe infestanti).

plantSpecies[]

object (PlantSpeciesInfo)

Suddivisione granulare delle specie di piante.

PollenCategoryInfo

Rappresentazione JSON
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Campi
displayName

string

Nome visualizzato della categoria (ad es. "Albero", "Erba", "Erba infestante").

inSeason

boolean

Indica se questa categoria di polline è in fioritura attiva nella regione.

index

object (PollenIndex)

Misurazione dell'indice universale dei pollini (UPI) per questa categoria.

healthRecommendations[]

string

Consigli utili per la salute dei gruppi sensibili ai pollini.

PollenIndex

Rappresentazione JSON
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campi
category

string

Classificazione delle categorie localizzate (ad es. "Nessuna", "Molto bassa", "Bassa", "Moderata", "Alta", "Molto alta").

description

string

Descrizione del livello di rischio di polline.

Campo unione _value.

_value può essere solo uno dei seguenti tipi:

value

integer

Valore UPI numerico (scala da 0 a 5).

PlantSpeciesInfo

Rappresentazione JSON
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Campi
code

string

Codice della specie leggibile da macchina (ad es. "BIRCH", "JAPANESE_CEDAR", "RAGWEED").

displayName

string

Nome visualizzato localizzato della specie di pianta (ad es. "Betulla").

family

string

Nome della famiglia botanica (ad es. "Betulacee (famiglia della betulla)").

inSeason

boolean

Indica se questa specie di pianta è attualmente in stagione.

index

object (PollenIndex)

Misurazione dell'indice universale dei pollini (UPI) per questa specie.

season

string

Descrizione della stagione di fioritura tipica (ad es. "Fine inverno, primavera").

crossReactions

string

Allergeni cross-reattivi noti (ad es. "Polline di ontano, nocciolo, faggio e quercia").

Unità

Rappresenta un'unità utilizzata per misurare le temperature.

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

Fase

Contrassegna la fase lunare.

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

Tipo

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

Nota: le condizioni con valori 42-139 sono attualmente restituite solo per le località in Giappone e Corea.

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 (solo nuvole, niente sole).
WINDY Vento forte.
WIND_AND_RAIN Vento forte con precipitazioni.
LIGHT_RAIN_SHOWERS Pioggia leggera intermittente.
CHANCE_OF_SHOWERS Possibilità di pioggia intermittente.
SCATTERED_SHOWERS Pioggia intermittente.
RAIN_SHOWERS Gli acquazzoni sono considerati precipitazioni di durata inferiore rispetto alla pioggia e sono caratterizzati da improvvisi orari di inizio e fine e da rapidi cambiamenti di intensità.
HEAVY_RAIN_SHOWERS Forti rovesci.
LIGHT_TO_MODERATE_RAIN Pioggia (da leggera a moderata).
MODERATE_TO_HEAVY_RAIN Pioggia (da moderata a forte).
RAIN Pioggia moderata.
LIGHT_RAIN Pioggia leggera.
HEAVY_RAIN Pioggia intensa.
RAIN_PERIODICALLY_HEAVY Pioggia, a tratti di forte intensità.
LIGHT_SNOW_SHOWERS Neve leggera che cade con intensità variabile per brevi periodi di tempo.
CHANCE_OF_SNOW_SHOWERS Possibili rovesci a carattere nevoso.
SCATTERED_SNOW_SHOWERS Neve che cade con 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 forte.
SNOW Neve moderata.
LIGHT_SNOW Leggere nevicate.
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 con intensità variabile per brevi periodi di tempo.
THUNDERSTORM Temporale.
THUNDERSHOWER Una pioggia accompagnata 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.
CLEAR_AFTER_FOG_IN_THE_MORNING Sereno dopo nebbia al mattino.
CLEAR_BUT_LATER_TURNING_CLOUDY Sereno, successivamente nuvoloso.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Sereno ma con pioggia e neve più tardi (prevalentemente pioggia).
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Sereno ma con neve e pioggia più tardi (prevalentemente neve).
CLEAR_BUT_THUNDERSTORMS_LATER Sereno con temporali più tardi.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Sereno al mattino ma nuvoloso in serata.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Sereno al mattino con brevi piogge in serata.
CLEAR_MORNING_WITH_BRIEF_RAIN Sereno al mattino con brevi piogge.
CLEAR_WITH_BRIEF_RAIN Sereno con brevi piogge.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Sereno con brevi rovesci e nevicate (prevalentemente pioggia).
CLEAR_WITH_BRIEF_RAIN_LATER Sereno con brevi rovesci più tardi.
CLEAR_WITH_BRIEF_SNOW Sereno con brevi nevicate.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Sereno con brevi nevicate e rovesci (prevalentemente neve).
CLEAR_WITH_BRIEF_SNOW_LATER Sereno con brevi nevicate più tardi.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Sereno, con nuvolosità intermittente più tardi.
CLEAR_WITH_PERIODIC_RAIN Sereno con piogge intermittenti.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Sereno con piogge intermittenti e tuoni.
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Sereno con piogge e nevicate intermittenti (prevalentemente pioggia).
CLEAR_WITH_PERIODIC_RAIN_LATER Sereno con piogge intermittenti più tardi.
CLEAR_WITH_PERIODIC_SNOW Sereno con nevicate intermittenti.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Sereno con nevicate e piogge intermittenti (prevalentemente neve).
CLEAR_WITH_PERIODIC_SNOW_LATER Sereno con successive nevicate intermittenti.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Sereno con pioggia dopo mezzanotte.
CLEAR_WITH_RAIN_IN_THE_NIGHT Sereno con pioggia in nottata.
CLEAR_WITH_RAIN_LATER Sereno con piogge più tardi.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Sereno con neve sui rilievi.
CLEAR_WITH_SNOW_LATER Sereno con successive nevicate.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Sereno con temporali sui rilievi.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Sereno con temporali nel pomeriggio.
CLOUDY_BUT_CLEAR_LATER Nuvoloso, ma con schiarite più tardi.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Nuvoloso, con piogge e nevicate più tardi (prevalentemente pioggia).
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Nuvoloso, con nevicate e piogge più tardi (prevalentemente neve).
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Nuvoloso, con schiarite a tratti più tardi.
CLOUDY_BUT_THUNDERSTORMS_LATER Nuvoloso con temporali più tardi.
CLOUDY_MORNING_WITH_BRIEF_RAIN Nuvoloso al mattino con brevi piogge.
CLOUDY_PERIODICALLY_CLEAR Nuvoloso con schiarite intermittenti.
CLOUDY_SNOWING_IN_THE_EVENING Nuvoloso con nevicate in serata.
CLOUDY_SNOWING_IN_THE_NIGHT Nuvoloso con nevicate in nottata.
CLOUDY_WITH_BRIEF_RAIN Nuvoloso con brevi piogge.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nuvoloso con brevi piogge e nevicate (prevalentemente pioggia).
CLOUDY_WITH_BRIEF_RAIN_LATER Nuvoloso con brevi rovesci più tardi.
CLOUDY_WITH_BRIEF_SNOW Nuvoloso con brevi nevicate.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nuvoloso con brevi nevicate e rovesci (prevalentemente neve).
CLOUDY_WITH_BRIEF_SNOW_LATER Nuvoloso con brevi nevicate più tardi.
CLOUDY_WITH_BRIEF_THUNDERSTORM Nuvoloso con brevi temporali.
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Nuvoloso con nebbia sull'oceano e sulla costa.
CLOUDY_WITH_PERIODIC_RAIN Nuvoloso con piogge intermittenti.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Nuvoloso con piogge intermittenti e tuoni.
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nuvoloso con piogge e nevicate intermittenti (prevalentemente pioggia).
CLOUDY_WITH_PERIODIC_RAIN_LATER Nuvoloso con successive piogge intermittenti.
CLOUDY_WITH_PERIODIC_SNOW Nuvoloso con nevicate intermittenti.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Nuvoloso con nevicate intermittenti e tuoni.
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nuvoloso con piogge e nevicate intermittenti (prevalentemente neve).
CLOUDY_WITH_PERIODIC_SNOW_LATER Nuvoloso con successive nevicate intermittenti.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Nuvoloso con pioggia dopo mezzanotte.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Nuvoloso con piogge verso mezzogiorno.
CLOUDY_WITH_RAIN_FROM_EVENING Nuvoloso con piogge dalla sera.
CLOUDY_WITH_RAIN_LATER Nuvoloso con piogge più tardi.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Nuvoloso con nevicate verso mezzogiorno.
CLOUDY_WITH_SNOW_LATER Nuvoloso con nevicate più tardi.
FOG Nebbia.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Acquaneve (prevalentemente pioggia) con schiarite più tardi.
RAINSNOW_MIX_RAIN_AS_MAIN Acquaneve (prevalentemente pioggia).
RAINY_BUT_PERIODICALLY_CLEAR Pioggia con schiarite intermittenti.
RAIN_ACCOMPANIED_BY_LIGHTNING Pioggia con fulmini.
RAIN_ACCOMPANIED_BY_WINDSTORM Pioggia con tempesta di vento.
RAIN_CLEAR_AT_NIGHT Piogge con schiarite in nottata.
RAIN_CLEAR_FROM_AROUND_EVENING Piogge con schiarite verso sera.
RAIN_CLEAR_FROM_AROUND_NOON Piogge con schiarite verso mezzogiorno.
RAIN_LATER_BECOMING_CLEAR Piogge con schiarite più tardi.
RAIN_LATER_BECOMING_CLOUDY Piogge con nubi più tardi.
RAIN_LATER_BECOMING_SNOW Piogge con nevicate più tardi.
RAIN_LATER_WITH_PERIODIC_SNOW Piogge con nevicate intermittenti più tardi.
RAIN_SNOW_AT_NIGHT Piogge e nevicate in nottata.
RAIN_SNOW_IN_THE_EVENING Piogge e nevicate in serata.
RAIN_TEMPORARILY_BECOMING_SLEET Piogge, temporaneamente a carattere di nevischio.
RAIN_THAT_PERIODICALLY_STOPS Piogge intermittenti.
RAIN_WITH_BRIEF_SNOW Pioggia con brevi nevicate.
RAIN_WITH_PERIODIC_SNOW Pioggia con neve intermittente.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Acquaneve (prevalentemente neve) con schiarite più tardi.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Acquaneve (prevalentemente neve) con nubi più tardi.
SNOWRAIN_MIX_SNOW_AS_MAIN Acquaneve (prevalentemente neve).
SNOW_ACCOMPANIED_BY_LIGHTNING Neve con fulmini.
SNOW_BECOMING_SLEET Nevicate a carattere di nevischio.
SNOW_LATER_CLEAR Nevicate con schiarite più tardi.
SNOW_LATER_CLOUDY Nevicate con nubi più tardi.
SNOW_LATER_RAIN Nevicate con piogge più tardi.
SNOW_PERIODICALLY_CLEAR Nevicate con schiarite a tratti.
SNOW_THAT_PERIODICALLY_STOPS Nevicate intermittenti.
SNOW_TURNING_TO_RAIN_AROUND_NOON Neve tendente a pioggia verso mezzogiorno.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Nevicate in passaggio a pioggia in serata.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Nevicate in passaggio a pioggia in nottata.
SNOW_WITH_BRIEF_RAIN Nevicate con brevi piogge.
SNOW_WITH_BRIEF_SLEET Neve con nevischio a tratti.
SNOW_WITH_PERIODIC_RAIN Neve con pioggia intermittente.
VERY_HOT Temperatura molto alta.
SLEET Pioggia gelata.
HEAVY_RAIN_TO_RAINSTORM Da pioggia intensa a temporale.

Tipo

Rappresenta il tipo di precipitazione in una determinata località.

Enum
TYPE_UNSPECIFIED Tipo di precipitazione non specificato.
NONE Nessuna precipitazione.
SNOW Precipitazioni nevose.
RAIN Precipitazioni piovose.
LIGHT_RAIN Precipitazioni di pioggia leggera.
HEAVY_RAIN Precipitazioni di pioggia intensa.
RAIN_AND_SNOW Precipitazioni sia di pioggia che di neve.
SLEET Precipitazioni di nevischio.
FREEZING_RAIN Precipitazioni di pioggia che si congela al suolo.
PRECIPITATION_TYPE_HAIL Precipitazioni di grandine.

Unità

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

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

Rosso cardinale

Rappresenta un punto cardinale (compresi i punti ordinali).

Enum
CARDINAL_UNSPECIFIED La direzione cardinale non è specificata.
NORTH La direzione 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 La direzione cardinale est.
EAST_SOUTHEAST La direzione intercardinale secondaria est-sud-est.
SOUTHEAST La direzione intercardinale sud-est.
SOUTH_SOUTHEAST La direzione intercardinale secondaria sud-sud-est.
SOUTH La direzione cardinale sud.
SOUTH_SOUTHWEST La direzione intercardinale secondaria sud-sudovest.
SOUTHWEST La direzione intercardinale sud-ovest.
WEST_SOUTHWEST La direzione intercardinale secondaria ovest-sud-ovest.
WEST La direzione cardinale ovest.
WEST_NORTHWEST La direzione intercardinale secondaria ovest-nord-ovest.
NORTHWEST La direzione intercardinale nord-ovest.
NORTH_NORTHWEST La direzione intercardinale secondaria nord-nord-ovest.

Unità

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

Enum
UNIT_UNSPECIFIED L'unità di misura della velocità non è specificata.
KILOMETERS_PER_HOUR La velocità è misurata in chilometri all'ora.
MILES_PER_HOUR La velocità viene misurata in miglia orarie.

Unità

Unità utilizzate per misurare la concentrazione di inquinanti.

Enum
UNIT_UNSPECIFIED Unità di concentrazione non specificata.
PARTS_PER_BILLION Parti per miliardo (ppb).
MICROGRAMS_PER_CUBIC_METER Microgrammi per metro cubo (µg/m³).

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌