MCP Tools Reference: mapstools.googleapis.com

Strumento: lookup_weather

Recupera dati meteo completi, tra cui condizioni attuali, previsioni orarie e giornaliere.

Dati specifici disponibili: temperatura (attuale, percepita, massima/minima, indice di calore), vento (velocità, raffiche, direzione), eventi celesti (alba/tramonto, fase lunare), precipitazioni (tipo, probabilità, quantità/QPF), condizioni atmosferiche (indice UV, umidità, copertura nuvolosa, probabilità di temporali) e indirizzo della posizione geocodificata.

Location & Location Rules (CRITICAL):

La località per cui vengono richiesti i dati meteo viene specificata utilizzando il campo location. Questo campo è una struttura "oneof", il che significa che DEVI fornire un valore per SOLO UNO dei tre sottocampi della località riportati di seguito per garantire una ricerca accurata dei dati meteo.

  1. Coordinate geografiche (lat_lng)

    • Utilizzalo quando ti vengono fornite coordinate di latitudine/longitudine esatte.
    • Esempio: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. ID luogo (place_id)

    • Un identificatore di stringa univoco (ID luogo di Google Maps).
    • Il place_id può essere recuperato dallo strumento search_places.
    • Esempio: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Torre Eiffel

  3. Stringa dell'indirizzo (address)

    • Una stringa in formato libero che richiede specificità per la geocodifica.
    • Città e regione: includi sempre la regione/il paese (ad es. "Londra, Regno Unito", non "Londra").
    • Indirizzo: fornisci l'indirizzo completo (ad es. "1600 Pennsylvania Ave NW, Washington, DC").
    • Codici postali: DEVONO essere accompagnati dal nome di un paese (ad es. "90210, USA", NON "90210").
    • Esempio: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Modalità di utilizzo:

  • Meteo attuale: fornisci solo location. Non specificare date e hour.

  • Previsione oraria: fornisci location, date e hour (0-23). Utilizza orari specifici (ad es. "alle 17:00") o termini come "prossime ore" o "più tardi oggi". Se l'utente specifica i minuti, arrotonda per difetto all'ora più vicina. La previsione oraria oltre le 120 ore da adesso non è supportata. Il meteo orario storico è supportato fino a 24 ore nel passato.

  • Previsioni giornaliere: fornisci location e date. Non specificare hour. Utilizza questa opzione per richieste generiche relative a un giorno (ad es. "meteo di domani", "meteo di venerdì", "meteo del 25/12"). Se la data odierna non è presente nel contesto, devi chiarirla con l'utente. La previsione giornaliera oltre i 10 giorni, incluso oggi, non è supportata. I dati storici sul meteo non sono supportati.

Vincoli dei parametri:

  • Fusi orari: tutti gli input date e hour devono essere relativi al fuso orario locale della sede, non a quello dell'utente.
  • Formato data: gli input devono essere separati in {year, month, day} numeri interi.
  • Unità: il valore predefinito è METRIC. Imposta units_system su IMPERIAL per Fahrenheit/miglia se l'utente fa riferimento agli standard statunitensi o li richiede esplicitamente.

  • L'output basato su dati reali deve essere attribuito alla fonte utilizzando le informazioni del campo attribution, se disponibili.

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)
  },

  // 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.
}
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.

Campo unione _date.

_date può essere solo uno dei seguenti tipi:
date

object (Date)

Facoltativo. La data delle informazioni meteo richieste. Nota: questa data è relativa al fuso orario locale della località specificata nel campo della località. La data deve essere compresa tra le 24 ore precedenti e i 10 giorni successivi.

Campo unione _hour.

_hour può essere solo uno dei seguenti tipi:
hour

integer

Facoltativo. L'ora delle informazioni meteo richieste, nel formato 24 ore (0-23). Questo valore è relativo al fuso orario locale della località specificata nel campo della località. La previsione oraria oltre le 120 ore da adesso non è supportata. Il meteo orario storico è supportato fino a 24 ore nel passato.

Data

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

integer

Anno della data. Deve essere 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 o Plus Code. Per maggiori dettagli, visita la pagina https://plus.codes.

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

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. gradi Celsius, chilometri e così via).

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.
}
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). Definisci facoltativo perché non è sempre disponibile

Campo unione _uv_index.

_uv_index può essere solo uno dei seguenti tipi:
uvIndex

integer

L'indice ultravioletto (UV) massimo. Definisci facoltativo perché non è sempre disponibile

Campo unione _thunderstorm_probability.

_thunderstorm_probability può essere solo uno dei seguenti tipi:
thunderstormProbability

integer

La probabilità di temporali (valori da 0 a 100). Definisci facoltativo perché non è sempre disponibile

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). Definisci facoltativo perché non è sempre disponibile

Temperatura

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

  // 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 (TemperatureUnit)

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 particolari (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 del 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 corrisponde 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 compreso tra 0 e 999.999.999 inclusi.

MoonEvents

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

string (Timestamp format)

L'ora 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 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".
moonPhase

enum (MoonPhase)

La fase lunare.

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, 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 (PrecipitationType),

  // 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 (PrecipitationType)

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 (CardinalDirection),

  // 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 (CardinalDirection)

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 (SpeedUnit),

  // 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 (SpeedUnit)

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 o Plus Code. Per maggiori dettagli, visita la pagina https://plus.codes.

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.

TemperatureUnit

Rappresenta un'unità utilizzata per misurare le temperature.

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

MoonPhase

Contrassegna 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 lo 0%-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.

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.

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

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.

CardinalDirection

Rappresenta un punto cardinale (compresi i punti ordinali).

Enum
CARDINAL_DIRECTION_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.

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à viene misurata in miglia all'ora.

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 un prompt 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: ❌