search_places |
Chiama questo strumento quando la richiesta dell'utente è trovare luoghi, attività, indirizzi, località, punti di interesse o qualsiasi altra ricerca correlata a Google Maps. Requisiti di input (FONDAMENTALI):
text_query (stringa - OBBLIGATORIO): la query di ricerca principale. Deve definire chiaramente ciò che l'utente sta cercando.
- Esempi:
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Per dettagli specifici sul luogo: includi l'attributo richiesto (ad es.
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (oggetto - FACOLTATIVO): utilizza questo campo per dare la priorità ai risultati vicini a un'area geografica specifica.
- Formato:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Utilizzo:
- Per applicare un bias a un raggio di 5 km:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Per applicare una forte inclinazione verso il punto centrale:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (omettendo radius_meters).
language_code (stringa - FACOLTATIVO): la lingua in cui mostrare il riepilogo dei risultati di ricerca.
- Formato: un codice lingua di due lettere (ISO 639-1), facoltativamente seguito da un trattino basso e da un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio
en, ja, en_US, zh_CN, es_MX. Se il codice lingua non viene fornito, i risultati saranno in inglese.
region_code (stringa - FACOLTATIVO): il codice regione CLDR Unicode dell'utente. Questo parametro viene utilizzato per visualizzare i Place Details, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente.
- Formato: un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio
US, CA.
Instructions for Tool Call:
Dati sulla posizione (CRITICO): la ricerca deve contenere dati sulla posizione sufficienti. Se la località è ambigua (ad es. solo "pizzerie"), devi specificarla nel parametro text_query (ad es. "pizzerie a New York") o utilizzare il parametro location_bias. Includi il nome della città, dello stato/della provincia e della regione/del paese, se necessario per evitare ambiguità. Fornisci sempre il text_query più specifico e ricco di contesto possibile. Utilizza location_bias solo se le coordinate vengono fornite esplicitamente o se è appropriato dedurre una posizione dal contesto noto di un utente e necessario per ottenere risultati migliori. L'output basato su dati reali deve essere attribuito alla fonte utilizzando le informazioni del campo attribution, se disponibili.
|
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.
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
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
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:
|
compute_routes |
Calcola i percorsi di viaggio tra un'origine e una destinazione, facoltativamente attraverso tappe intermedie. Restituisce la distanza e la durata di ogni percorso. Requisiti di input (FONDAMENTALI):
origin e destination (oggetti - OBBLIGATORI): ciascuno deve essere fornito utilizzando esattamente uno dei seguenti elementi:
address (stringa, ad es. 'Eiffel Tower, Paris'). I luoghi, i punti di riferimento e le attività con un nome vengono risolti direttamente, quindi NON chiamare prima search_places solo per geocodificare un waypoint. Includi qualsiasi città, regione o paese menzionato dall'utente.lat_lng (oggetto, {"latitude": number, "longitude": number}).place_id (stringa, ad esempio 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), ad esempio da search_places. intermediate_waypoints (array di oggetti - FACOLTATIVO): fino a 10 tappe da attraversare, in ordine, tra l'origine e la destinazione. Stesso formato di origin. Non supportato con TRANSIT. Includi solo le fermate richieste dall'utente.
travel_mode (enum - FACOLTATIVO): DRIVE (predefinito), WALK, BICYCLE o TRANSIT.
Tempistica (FACOLTATIVO - imposta al massimo UN valore): timestamp RFC 3339 con un offset UTC, ad esempio '2026-09-19T08:00:00-07:00'. Il valore predefinito è la partenza immediata. Per TRANSIT, l'ora può essere impostata fino a 7 giorni nel passato o fino a 100 giorni nel futuro. Per le altre modalità, l'ora può essere impostata fino a 365 giorni nel futuro e non deve essere nel passato.
departure_time: da utilizzare quando l'utente indica quando partirà (ad es. "domani alle 8:00").arrival_time: da utilizzare quando l'utente indica l'orario di arrivo (ad es. "arrivo entro le 9:00"). routing_preference (enum - FACOLTATIVO):
ROUTING_PREFERENCE_TRAFFIC_UNAWARE (valore predefinito): ignora il traffico in tempo reale, gli incidenti e le chiusure. Latenza minima.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: utilizza le condizioni del traffico in tempo reale, se disponibili. Non supportato per WALK o BICYCLE. Imposta questo valore SOLO quando l'utente chiede informazioni sul traffico, sulla congestione o su un orario di arrivo stimato basato sul traffico. Comporta costi e latenza più elevati. location_bias (oggetto - FACOLTATIVO): {"latitude": number, "longitude": number} utilizzato per eliminare l'ambiguità dei nomi dei luoghi negli indirizzi dei waypoint. Se un nome è ambiguo (ad es. "Springfield") e l'utente non ha fornito una regione, mantieni il nome così come è stato fornito in address e imposta location_bias sull'area prevista anziché indovinare una regione.
compute_alternative_routes (booleano - FACOLTATIVO): imposta su true solo quando l'utente chiede opzioni o alternative per il percorso. Il valore predefinito è false, che restituisce solo il percorso consigliato.
include_polyline (booleano - FACOLTATIVO): imposta su true solo quando è necessaria la geometria del percorso (encoded_polyline). Il valore predefinito è false.
Instructions for Tool Call:
- Se l'origine o la destinazione non sono presenti, DEVI chiedere chiarimenti all'utente prima di chiamare lo strumento.
- Per le domande del tipo "Quanto dista A da B?", utilizza B come
origin e A come destination.
Esempio di chiamata dello strumento: {"origin":{"address":"Torre Eiffel"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Museo del Louvre"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Instructions for Response:
- Quando vengono richiesti percorsi alternativi, questi vengono ordinati dal più consigliato al meno consigliato.
- Se
routes è vuoto, comunica all'utente che non è stato trovato alcun percorso. Non provare a indovinare un percorso.
- Indica solo i fatti restituiti dallo strumento. NON inventare indicazioni stradali passo passo, linee di trasporto pubblico, stazioni, piattaforme o cambi.
- L'output basato su dati reali deve essere attribuito alla fonte utilizzando il campo
attribution di ogni percorso, se disponibile.
|
resolve_names |
Risolve un elenco in batch di query di località specifiche (nomi di punti di riferimento o indirizzi esatti) in ID luogo di Google Maps canonici. Requisiti di input (FONDAMENTALI):
queries (array di oggetti - OBBLIGATORIO): un elenco di query di località da risolvere. Puoi specificare fino a 20 query.
- Ogni oggetto query deve avere:
text (stringa - OBBLIGATORIO): la query di testo che rappresenta un nome o un indirizzo di un luogo specifico da risolvere.
- Esempi:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (oggetto - FACOLTATIVO): utilizza questo campo per dare la priorità ai risultati vicini a un'area geografica specifica.
- Formato:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (stringa - FACOLTATIVO): il codice regione CLDR Unicode (codice paese di due lettere, ad esempio US, CA) dell'utente per influenzare i risultati.
Instructions for Tool Call:
- Specificità (CRITICO): le query devono rappresentare un nome o un indirizzo di un luogo specifico. Le ricerche generiche come
'restaurants' o i nomi di catene come 'Starbucks' non sono supportati.
- NON chiamare questo strumento se gli strumenti downstream che prevedi di richiamare accettano già direttamente stringhe di indirizzi o nomi di luoghi non elaborati.
Salva in Google Maps:
- La risposta include un campo
save_to_maps_url: un singolo link a Google Maps contenente tutti i luoghi risolti correttamente.
- Quando l'utente vuole salvare, condividere o aprire i luoghi risolti come elenco in Google Maps, presentagli questo link. NON creare questo link manualmente.
Gestione degli errori (CRITICA):
- Si tratta di uno strumento di elaborazione batch. Una richiesta potrebbe restituire "risultati misti" (ad esempio, alcune query vengono risolte correttamente, mentre altre non vanno a buon fine).
- È garantito che l'elenco di output di
results corrisponda 1:1 agli indici di input queries. Una query non riuscita genererà un messaggio Result vuoto (nessun entity impostato) nell'indice corrispondente nell'elenco results.
- DEVI controllare il campo della mappa
failed_requests nella risposta per identificare l'indice di query specifico che non è riuscito. La chiave di failed_requests rappresenta l'indice in base zero della query non riuscita nella richiesta. Non dare per scontato che l'intera chiamata batch non sia riuscita a causa di un errore parziale.
|
resolve_maps_urls |
Risolve un elenco di URL di Google Maps in ID luogo canonici di Google Maps. Quando chiamare questo strumento (CRITICO):
- Utilizza questo strumento quando l'utente fornisce uno o più link o URL di condivisione di Google Maps (ad es. "https://maps.app.goo.gl/…", "https://www.google.com/maps/place/…" o "https://maps.google.com/…") e devi estrarre gli ID luogo canonici sottostanti.
- Puoi specificare fino a 20 URL da risolvere in una singola richiesta batch.
Requisiti di input (FONDAMENTALI):
urls (array di stringhe - OBBLIGATORIO): l'elenco di URL di Google Maps da risolvere. Ogni URL deve essere un URL di Google Maps valido e relativo a un singolo luogo. Salva in Google Maps:
- La risposta include un campo
save_to_maps_url: un singolo link a Google Maps contenente tutti i luoghi risolti correttamente.
- Quando l'utente vuole salvare, condividere o aprire i luoghi risolti come elenco in Google Maps (ad es. raccogliere i luoghi condivisi in una conversazione), presentagli questo link. NON creare questo link manualmente.
Gestione degli errori (CRITICA):
- Si tratta di uno strumento di elaborazione batch. Una richiesta potrebbe restituire "risultati misti" (ad esempio, alcuni URL vengono risolti correttamente, mentre altri no).
- È garantito che l'elenco di output di
entities corrisponda 1:1 agli indici di input urls. Una risoluzione dell'URL non riuscita genererà un messaggio Entity vuoto (nessun campo impostato) nell'indice corrispondente nell'elenco entities.
- DEVI controllare il campo della mappa
failed_requests nella risposta per identificare l'indice dell'URL specifico che non è riuscito. La chiave di failed_requests rappresenta l'indice in base zero dell'URL non riuscito nella richiesta. Non dare per scontato che l'intera chiamata batch non sia riuscita a causa di un errore parziale.
|
