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, max/min, 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 località geocodificata.

Posizione e regole per località (CRITICO):

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 di località riportati di seguito per garantire una ricerca accurata dei dati meteo.

  1. Coordinate geografiche (lat_lng)

    • Utilizzalo quando ti vengono fornite le coordinate esatte di latitudine e longitudine.
    • 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).
    • L'ID luogo può essere recuperato dallo strumento search_places.
    • Esempio: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eiffel Tower

  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 "nelle prossime ore" o "più tardi oggi". Se l'utente specifica i minuti, arrotonda per difetto all'ora più vicina. Non sono supportate previsioni orarie oltre le 120 ore successive. I dati meteo orari storici sono supportati fino a 24 ore nel passato.

  • Previsioni giornaliere: fornisci location e date. Non specificare hour. Utilizza questa opzione per le richieste generali relative al giorno (ad es. "che tempo farà domani?", "che tempo farà venerdì?", "che tempo farà il 25/12?"). Se la data odierna non è nel contesto, devi chiarirla con l'utente. Non è supportata la previsione giornaliera oltre i 10 giorni, incluso quello corrente. Il meteo storico non è supportato.

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 lo richiede esplicitamente.

  • L'output fondato 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 del metodo LookupWeather, che 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 24 ore nel passato e i prossimi 10 giorni.

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 posizione specificata nel campo della posizione. Non sono supportate previsioni orarie oltre le 120 ore successive. I dati meteo orari storici sono supportati 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 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure tra 0 e 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 compreso tra 0 e 31 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 posizione .
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à 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).

Schema di output

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

Questa risposta rappresenta informazioni orarie e giornaliere, pertanto è suddivisa in tre sezioni: Oraria, Giornaliera e Condivisa. I campi Solo orario e Solo giornaliero 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)

Condizione meteo
precipitation

object (Precipitation)

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

object (Wind)

Condizioni del vento
returnedLocation

object (Location)

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

object (Attribution)

Attribuzione obbligatoria da mostrare con le informazioni 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 oraria dell'indice di calore.

Campo unione _air_pressure.

_air_pressure può essere solo uno dei seguenti tipi:
airPressure

object (AirPressure)

Le condizioni di pressione atmosferica orarie.

Campo unione _max_temperature.

_max_temperature può essere solo uno dei seguenti tipi:
maxTemperature

object (Temperature)

La temperatura massima (alta) durante la giornata.

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) durante la 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) durante la 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 la giornata.

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 temporale (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 coperta dalle 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 l'ora dell'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 di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a 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 porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Il valore 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)

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

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

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)

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

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

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

object (LocalizedText)

La descrizione testuale di questa condizione meteo (localizzata).
type

enum (Type)

Il tipo di condizione meteorologica.

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ù, visita 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 (consulta la definizione di QuantitativePrecipitationForecast per maggiori dettagli).
qpf

object (QuantitativePrecipitationForecast)

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

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, che si è 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 posizione .
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 collegarsi per l'attribuzione.

TemperatureUnit

Rappresenta un'unità utilizzata per misurare le temperature.

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

MoonPhase

Indica la fase lunare.

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

Tipo

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

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

PrecipitationType

Rappresenta il tipo di precipitazione in una determinata località.

Enum
PRECIPITATION_TYPE_UNSPECIFIED Tipo di precipitazione non specificato.
NONE Nessuna precipitazione.
SNOW Precipitazioni nevose.
RAIN Precipitazioni di pioggia.
LIGHT_RAIN Precipitazioni di pioggia leggera.
HEAVY_RAIN Forti precipitazioni piovose.
RAIN_AND_SNOW Precipitazioni di pioggia e neve.
SLEET Precipitazioni di nevischio.
FREEZING_RAIN Precipitazioni di pioggia 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 una direzione cardinale (incluse le direzioni ordinali).

Enum
CARDINAL_DIRECTION_UNSPECIFIED La direzione cardinale non è specificata.
NORTH Il punto cardinale nord.
NORTH_NORTHEAST La direzione secondaria intercardinale nord-nord-est.
NORTHEAST La direzione intercardinale nord-est.
EAST_NORTHEAST La direzione intercardinale secondaria est-nord-est.
EAST Il punto cardinale est.
EAST_SOUTHEAST La direzione intercardinale secondaria est-sud-est.
SOUTHEAST La direzione intercardinale sud-est.
SOUTH_SOUTHEAST La direzione secondaria intercardinale sud-sud-est.
SOUTH Il punto cardinale sud.
SOUTH_SOUTHWEST La direzione secondaria intercardinale sud-sud-ovest.
SOUTHWEST La direzione intercardinale sud-ovest.
WEST_SOUTHWEST La direzione intercardinale secondaria ovest-sud-ovest.
WEST Il punto cardinale ovest.
WEST_NORTHWEST La direzione 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à è misurata in miglia orarie.

Annotazioni dello strumento

Le annotazioni dello strumento 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, sono definiti i seguenti suggerimenti booleani:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, chiamare ripetutamente lo 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 le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌