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

Posizione e regole per la posizione (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 UNO SOLO dei tre sottocampi di posizione riportati di seguito per garantire una ricerca accurata dei dati meteo.

Coordinate geografiche (lat_lng)
- Utilizzalo quando ti vengono fornite le coordinate di latitudine/longitudine esatte.
- Esempio: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
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
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. La previsione oraria oltre le 120 ore successive non è supportata. I dati meteo orari storici sono supportati fino a 24 ore nel passato.
Previsione giornaliera:fornisci location e date. Non specificare hour. Utilizza per 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. La previsione giornaliera oltre i 10 giorni, incluso quello corrente, non è supportata. Le condizioni meteo storiche non sono supportate.

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 basato su dati reali deve essere attribuito alla fonte utilizzando le informazioni del campo attribution, se disponibili.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP lookup_weather.

Curl Request
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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

Curl Request

                  
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta del metodo LookupWeather, che rappresenta le condizioni meteo nella località richiesta.

LookupWeatherRequest

Rappresentazione JSON

Rappresentazione JSON
{ "DEPRECATEDAddress": string, "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`. }

{
  "DEPRECATEDAddress": string,
  "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

Campi
`DEPRECATEDAddress (deprecated)`	`string` Questo elemento è deprecato. DEPRECATO: utilizza la posizione.
`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, in formato di 24 ore (0-23). Questo valore è relativo al fuso orario locale della posizione specificata nel campo della posizione. La previsione oraria oltre le 120 ore successive non è supportata. I dati meteo orari storici sono supportati fino a 24 ore nel passato.

DEPRECATEDAddress
(deprecated)

string

DEPRECATO: utilizza la posizione.

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, in formato di 24 ore (0-23). Questo valore è relativo al fuso orario locale della posizione specificata nel campo della posizione. La previsione oraria oltre le 120 ore successive non è supportata. I dati meteo orari storici sono supportati fino a 24 ore nel passato.

Data

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

Campi

Campi
`year`	`integer` L'anno della data. Deve essere compreso tra 1 e 9999 oppure tra 0 e 9999 per specificare una data senza anno.
`month`	`integer` Mese dell'anno. Deve essere compreso tra 1 e 12 o 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.

year

integer

L'anno della data. Deve essere compreso tra 1 e 9999 oppure tra 0 e 9999 per specificare una data senza anno.

month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 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

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

{

  // 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 un plus code. Per ulteriori dettagli, visita la pagina https://plus.codes.

LatLng

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

Campi

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

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

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

Rappresentazione JSON
{ "weatherCondition": { object (`WeatherCondition`) }, "precipitation": { object (`Precipitation`) }, "wind": { object (`Wind`) }, "DEPRECATEDGeocodedAddress": string, "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`. }

{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "DEPRECATEDGeocodedAddress": string,
  "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

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
`DEPRECATEDGeocodedAddress (deprecated)`	`string` Questo elemento è deprecato. DEPRECATO: utilizza returned_location.
`returnedLocation`	`object (Location)` Obbligatorio. La località per cui vengono restituite le informazioni meteo. Questa posizione è identica a quella nella 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 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 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 oraria.
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 il giorno.
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 da nuvole (valori da 0 a 100). Definisci facoltativo perché non è sempre disponibile

weatherCondition

object (WeatherCondition)

Condizione meteo

precipitation

object (Precipitation)

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

wind

object (Wind)

Condizioni del vento

DEPRECATEDGeocodedAddress
(deprecated)

string

DEPRECATO: utilizza returned_location.

returnedLocation

object (Location)

Obbligatorio. La località per cui vengono restituite le informazioni meteo. Questa posizione è identica a quella nella 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 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 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 oraria.

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

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

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.

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

Campi
Campo unione `_mean_sea_level_millibars`. `_mean_sea_level_millibars` può essere solo uno dei seguenti tipi:
`meanSeaLevelMillibars`	`number` La pressione atmosferica media al livello del mare in millibar.

Campo unione _mean_sea_level_millibars.

_mean_sea_level_millibars può essere solo uno dei seguenti tipi:

meanSeaLevelMillibars

number

La pressione atmosferica media al livello del mare in millibar.

SunEvents

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

Campi

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 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 unici (ad es. a nord del circolo polare artico) potrebbe non esserci un orario del tramonto per un giorno. In questi casi, questo campo non verrà impostato. 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"`.

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 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 unici (ad es. a nord del circolo polare artico) potrebbe non esserci un orario del tramonto per un giorno. In questi casi, questo campo non verrà impostato.

Timestamp

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

Campi

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 (corrispondenti 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 vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

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 (corrispondenti 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 vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

MoonEvents

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

Campi

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

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

moonsetTimes[]

string (Timestamp format)

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

moonPhase

enum (MoonPhase)

La fase lunare.

WeatherCondition

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

Campi

Campi
`iconBaseUri`	`string` L'URI di base per l'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 meteorologica.

iconBaseUri

string

L'URI di base per l'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 meteorologica.

LocalizedText

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

Campi

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 maggiori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

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 maggiori informazioni, 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

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 Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di Previsione quantitativa delle precipitazioni).
`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 Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di Previsione quantitativa delle precipitazioni).

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 Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di Previsione quantitativa delle precipitazioni).

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 Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di Previsione quantitativa delle precipitazioni).

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

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 la probabilità di precipitazioni.

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

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 determinato periodo di tempo.

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 determinato periodo di tempo.

Wind

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

Campi

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

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

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

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

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.

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

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

{

  // 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 un plus code. Per ulteriori dettagli, visita la pagina https://plus.codes.

LatLng

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

Campi

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

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

Campi
`title`	`string` Il titolo da visualizzare per l'attribuzione.
`url`	`string` L'URL a cui rimandare per l'attribuzione.

title

string

Il titolo da visualizzare per l'attribuzione.

url

string

L'URL a cui rimandare per l'attribuzione.

Annotazioni dello strumento

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

MCP Tools Reference: mapstools.googleapis.com Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Strumento: lookup_weather

Schema di input

LookupWeatherRequest

Data

Località

LatLng

Schema di output

LookupWeatherResponse

Temperatura

AirPressure

SunEvents

Timestamp

MoonEvents

WeatherCondition

LocalizedText

Precipitazioni

PrecipitationProbability

QuantitativePrecipitationForecast

Wind

WindDirection

WindSpeed

Località

LatLng

Attribuzione

Annotazioni dello strumento

MCP Tools Reference: mapstools.googleapis.com

Strumento: `lookup_weather`