Grounding con Google Maps in Gemini Enterprise Agent Platform

Questa pagina descrive come il grounding con Google Maps con Gemini Enterprise Agent Platform può aiutarti a migliorare le tue applicazioni di AI generativa fornendo un contesto geospaziale.

Panoramica

Grounding con Google Maps con Gemini Enterprise Agent Platform è un servizio che collega i modelli Gemini ai dati geospaziali di Google Maps. Google Maps ha accesso alle informazioni su milioni di località, tra cui attività, punti di riferimento e punti d'interesse. Questi dati ti consentono di accedere a informazioni su oltre 250 milioni di luoghi che possono essere utilizzati per basare le risposte del tuo modello, consentendo alle tue applicazioni e ai tuoi agenti di AI di fornire dati locali e contesto geospaziale.

Puoi anche attivare il grounding simultaneo con Google Maps, la Ricerca Google e le tue origini dati.

Utilizzi del grounding con Google Maps

Puoi utilizzare Grounding con Google Maps per varie applicazioni, ad esempio:

  • Assistenti conversazionali in grado di rispondere a domande su luoghi nelle vicinanze, ad esempio "Dov'è il posto più vicino per prendere un espresso italiano?"
  • Descrizioni personalizzate e approfondimenti della community, ad esempio "Puoi dirmi di più sui ristoranti adatti a tutta la famiglia che si trovano a breve distanza a piedi?"
  • Riepiloghi delle aree intorno a località specifiche, come una stazione di ricarica EV o un hotel.

Questo può essere utile per i casi d'uso nel settore immobiliare, dei viaggi, della mobilità e delle app di social media.

Modelli supportati

Questa sezione elenca i modelli che supportano il grounding con Google Maps.

Fai clic per espandere i modelli supportati

Per ulteriori informazioni sui modelli Gemini, vedi Modelli Gemini.

Utilizza Grounding con Google Maps per basare le risposte del modello su dati reali

Questo esempio di codice mostra come utilizzare il grounding con Google Maps per basare le risposte del modello.

I risultati di ricerca possono essere personalizzati per una posizione geografica specifica utilizzando le coordinate di latitudine e longitudine.

Console

Per utilizzare il grounding con Google Maps con Gemini Enterprise Agent Platform, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Agent Studio.

    Vai ad Agent Studio

  2. Nel riquadro laterale, in Impostazioni modello, vai alla sezione Grounding e fai clic sull'icona di modifica per Ricerca Google, Google Maps. Viene visualizzato un riquadro di configurazione.

  3. Attiva l'opzione Google Maps.

  4. Fai clic su Applica.

  5. Inserisci il prompt nel campo e fai clic su Invia. Le risposte ai tuoi prompt si basano su Google Maps.

Python

Installa

pip install --upgrade google-genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleMaps,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Where can I get the best espresso near me?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Maps Tool
            Tool(google_maps=GoogleMaps())
        ],
        tool_config=types.ToolConfig(
            retrieval_config = types.RetrievalConfig(
                lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
                    latitude=40.7128,
                    longitude=-74.006
                ),
                language_code = "en_US", # Optional: localize Maps results
            ),
        ),
    ),
)

print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • LOCATION: la regione in cui elaborare la richiesta. Per utilizzare l'endpoint globale, escludi la località dal nome dell'endpoint e configura la località della risorsa su globale.
  • PROJECT_ID: il tuo ID progetto. .
  • MODEL_ID: l'ID del modello multimodale.
  • PROMPT: il prompt da inviare al modello.
  • LATITUDE: la latitudine della località. Ad esempio, una latitudine di 37.7749 rappresenta San Francisco. Puoi ottenere le coordinate di latitudine e longitudine utilizzando servizi come Google Maps o altri strumenti di geocodifica.
  • LONGITUDE: la longitudine della località. Ad esempio, una longitudine di -122.4194 rappresenta San Francisco.
  • GROUNDING_TYPES: i tipi di grounding di Google Maps da attivare. Al momento supporta places e routing.
    • places: cerca informazioni sui luoghi, tra cui attività, punti di interesse principali e posizioni geografiche.
    • routing: trova indicazioni stradali e cerca lungo il percorso.
    Se non specificato, i modelli Gemini 4 e versioni successive attivano places e routing, mentre i modelli precedenti attivano solo places. Se specificato, vengono abilitati solo i tipi elencati.

Metodo HTTP e URL: 

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Corpo JSON della richiesta: 

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "PROMPT"
    }]
  }],
  "tools": [{
    "googleMaps": {
      "groundingTypes": {
        "places": {},
        "routing": {}
      }
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      "languageCode": "en_US"
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "The Italian Place",
              "placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "Hank's Pasta Bar",
              "placeId": "places/MMVtPzn9FGcevML89",
              "placeAnswerSources": {
                "reviewSnippets": [
                  {
                    "id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
                    "title": "Google Maps Review",
                    "uri": "https://maps.google.com/?cid=9001322937822692826"
                  },
                ]
              }
            }
          },
          ...
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 79,
              "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ],
      }
    }
  ],
  ...
}

Proprietà dei luoghi

Questa sezione elenca le proprietà dei luoghi utilizzate per descrivere le località e utilizzate dal grounding con Google Maps per generare risposte. Queste proprietà vengono utilizzate per determinare i tipi di domande a cui il Grounding con Google Maps può rispondere.

Proprietà dei luoghi di esempio

Questo elenco fornisce un esempio in ordine alfabetico delle proprietà dei luoghi che possono essere utilizzate dal modello per generare risposte:

  • Indirizzo
  • Tendenze di affollamento
  • Ritiro all'esterno
  • Carta di debito
  • Distanza
  • Informazioni sulle stazioni di ricarica EV (tipi di connettori, velocità di ricarica e disponibilità)
  • Parcheggio gratuito
  • Prezzi e tipi di carburante disponibili
  • Adatto ai bambini
  • Musica dal vivo
  • Specialità del menu
  • Orario di apertura
  • Opzioni di pagamento (ad esempio contanti o carta di credito)
  • Animali ammessi
  • Esamina gli insight
  • Serve birra
  • Serve cibo vegetariano
  • Accessibile in sedia a rotelle
  • Wi-Fi

Esempi di utilizzo delle proprietà dei luoghi

Gli esempi seguenti utilizzano le proprietà dei luoghi nelle domande su diversi tipi di luoghi. Il grounding con Google Maps utilizza le proprietà per comprendere l'intent e poi fornisce risposte pertinenti in base ai dati associati ai luoghi in Google Maps.

  • Pianifica una cena in famiglia: potresti chiedere: "The Italian Place" è adatto ai bambini e offre il servizio di asporto? Qual è la loro valutazione?

    Le risposte a queste domande ti aiutano a determinare se un ristorante è adatto a una famiglia e se offre un servizio conveniente.

  • Esplora i piatti forti e le specialità del menu: potresti chiedere Quali sono i piatti di pasta più consigliati nel menu di "The Italian Place"? Hanno piatti vegetariani? Cosa dicono i recensori della loro salsa marinara?

    Le risposte a queste domande utilizzano i piatti forti del menu e gli approfondimenti sulle recensioni per aiutarti a esplorare offerte culinarie specifiche e i piatti preferiti della community.

  • Verificare l'accessibilità per un amico: potresti chiedere "Ho bisogno di un ristorante con un ingresso accessibile in sedia a rotelle".

    Una risposta a questo prompt potrebbe aiutarti a determinare se la località soddisfa esigenze di accessibilità specifiche.

  • Trovare un posto dove mangiare uno spuntino a tarda notte: potresti chiedere ""Burger Joint" è aperto adesso? Servono la cena? Quali sono gli orari di apertura per venerdì?

    Le risposte a queste domande ti aiutano a trovare un'attività aperta che serve un pasto specifico in un determinato momento.

  • Pianifica la ricarica EV e i servizi dell'hotel per un viaggio in auto: potresti chiedere: Soggiorno presso "Overnight Motel". Hanno stazioni di ricarica EV in loco, quali tipi di connettori sono supportati e quanto è affollato il parcheggio il venerdì sera?

    Le risposte a queste domande combinano le informazioni sulla stazione di ricarica EV e le tendenze di affollamento per aiutarti a pianificare la ricarica del veicolo e valutare i livelli di affollamento durante il soggiorno.

  • Confronta i prezzi del carburante e dei carburanti speciali nelle vicinanze: potresti chiedere: Quali stazioni di servizio vicino a Mountain View, in California, vendono diesel o idrogeno e come si confrontano i loro prezzi attuali?

    Le risposte a queste domande sfruttano i prezzi del carburante e i tipi di carburante disponibili per aiutarti a trovare carburanti speciali e stazioni di rifornimento convenienti.

  • Sintetizza l'atmosfera di lavoro dalle recensioni: puoi chiedere Cosa dicono i riepiloghi delle recensioni dei clienti sul livello di rumore, sul comfort delle sedute e sull'affidabilità del Wi-Fi presso "Breakfast Cafe" per il lavoro da remoto?

    Una risposta a questo prompt sfrutta gli approfondimenti sulle recensioni per valutare l'idoneità di un bar per lavorare o studiare in base al consenso della community.

Le informazioni contenute nei Risultati fondati di Google Maps potrebbero differire dalle condizioni effettive della strada o del luogo.

Comprendi la risposta

Le fonti di Google Maps vengono restituite in groundingMetadata all'interno di groundingChunks. Vengono restituite le fonti per i luoghi, che vengono utilizzate per generare il Risultato fondato di Google Maps. Il campo uri può rimandare a una recensione di supporto o direttamente alla scheda del luogo su Google Maps.

Questo esempio di codice mostra una fonte di luogo nella risposta:

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to place sheet or review on Maps}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}"
    }
  }
],

Routing - Find Directions

Il grounding con Google Maps supporta la funzionalità Trova indicazioni stradali. Questa funzionalità consente agli agenti AI di comprendere i movimenti fisici, le stime di viaggio in tempo reale e le relazioni spaziali tra le località. Con la funzionalità Trova indicazioni stradali, il tuo modello può fornire indicazioni stradali ottimizzate per le prestazioni e tempi di percorrenza accurati che tengono conto delle condizioni in tempo reale. Questa integrazione consente al grounding con Google Maps di filtrare i luoghi in base al tempo di percorrenza, offrire indicazioni stradali precise da un punto all'altro e calcolare i tempi di percorrenza stimati per modalità di trasporto specifiche.

Funzionalità

Find Directions calcola le distanze e le durate di viaggio precise tra origini e destinazioni.

Trova indicazioni stradali supporta quanto segue:

  • Mezzi di trasporto: percorsi per auto, a piedi, in bicicletta, con il trasporto pubblico e con veicoli a motore a due ruote (non tutti i mezzi di trasporto sono disponibili in tutti i paesi)

  • Più tappe: fino a 13 fermate intermedie tra l'origine e la destinazione

  • Traffico in tempo reale: tiene conto delle condizioni del traffico attuali per fornire tempi di percorrenza "in tempo reale" accurati anziché medie statiche

Di seguito sono riportati alcuni esempi dei tipi di domande supportati da Trova indicazioni stradali:

  • Vicinanza in base al tempo di percorrenza: "Quali sono alcuni ristoranti americani a 10 minuti a piedi dall'Hilton Hotel al 1335 della 6th Ave a New York?"

  • Stima del tragitto giornaliero: "Quanto tempo ci vuole per andare con i mezzi pubblici dal Mercato di San Lorenzo a Piazza della Signoria a Firenze?"

Attiva Trova indicazioni stradali

Nell'API REST e negli SDK, ciò che il grounding con Google Maps abilita quando grounding_types viene omesso dipende dal modello:

  • Modelli Gemini 4 e versioni successive: Places e Routing, quindi Trova indicazioni stradali è disponibile per impostazione predefinita.
  • Modelli precedenti: solo dati di Places. Per abilitare le funzionalità relative alle indicazioni stradali, devi configurare esplicitamente routing in grounding_types nella configurazione della richiesta.

Se imposti grounding_types, vengono attivati solo i tipi di grounding elencati. Per utilizzare sia gli strumenti Places che quelli Routing, specifica sia places che routing in grounding_types. Per utilizzare solo i dati di Places, specifica solo places.

Comprendi la risposta

Quando un prompt attiva la funzionalità Trova indicazioni stradali, il modello genera una risposta in linguaggio naturale supportata da metadati strutturati. In questo modo, puoi mostrare all'utente informazioni precise sul viaggio.

I seguenti dati vengono restituiti in una risposta del payload:

  • Durata: il tempo necessario per spostarsi tra le località, tenendo conto del traffico, se richiesto. Ad esempio, "500 seconds".

  • Distanza: la distanza fisica del percorso. Ad esempio, "1,9 km".

  • Polilinea: una stringa di testo codificata che ti consente di visualizzare il percorso specifico su una mappa.

Di seguito è riportato un esempio di risposta al prompt: "Come faccio ad arrivare al ristorante Carmine's dall'Hilton Hotel (1335 6th Ave a New York) dove alloggio?"

Per raggiungere il ristorante Carmine's dall'Hilton Hotel al 1335 della 6th Ave di New York, devi andare alla sede di Carmine's - Times Square al 200 della W 44th St, New York, NY 10036, USA.

Ecco le indicazioni a piedi:

  1. Partenza dall'Hilton Hotel: esci dall'Hilton Hotel al 1335 di 6th Ave.

  2. Cammina verso sud sulla 6th Avenue: procedi verso sud sulla 6th Avenue (Avenue of the Americas) in direzione di W 44th Street.

  3. Svolta a destra su W 44th Street: svolta a destra su W 44th Street.

  4. Carmine's è sulla sinistra: cammina lungo W 44th Street e Carmine's sarà sulla sinistra al numero 200.

Questo percorso è di circa 800 metri e dovrebbe richiedere circa 10-15 minuti.

Di seguito è riportato un esempio di risposta al prompt: "Quanto tempo ci vuole per raggiungere Capitol Hill da Pike Place Market a Seattle con i mezzi pubblici?"

Per andare da Pike Place Market a Capitol Hill a Seattle con i mezzi pubblici, hai un paio di opzioni:

  • Tram (metropolitana leggera): il tram da Westlake, vicino al Pike Place Market, a Capitol Hill impiega circa 3 minuti. Inclusi i cambi, il tempo di percorrenza totale è di circa 9 minuti, con tram in partenza ogni 10 minuti.

  • Autobus: un autobus diretto della King County Metro da Pike St & 4th Ave (vicino a Pike Place Market) a Capitol Hill impiega circa 11 minuti, con partenze ogni 20 minuti. In alternativa, l'autobus della linea 49 impiega circa 16 minuti.

Routing - Search Along Route

La funzionalità Ricerca lungo il percorso consente agli agenti AI di scoprire punti di interesse che sono geograficamente pertinenti e comodi per il percorso pianificato di un utente. Basando le risposte sui motori di ricerca spaziale e di routing di Google Maps, il tuo modello può fornire consigli che riducono al minimo le deviazioni e comprendono il flusso logistico di un viaggio o di un tragitto giornaliero.

Funzionalità

La funzionalità Ricerca lungo il percorso consente alla tua applicazione di identificare attività, comfort o attrazioni specifici situati direttamente lungo un percorso generato tra un luogo di partenza e una destinazione. È supportata solo la modalità di viaggio "In auto".

I seguenti esempi illustrano i tipi di domande che lo strumento Ricerca lungo il percorso può gestire.

  • Ricerca di un percorso di base: "Trova stazioni di servizio lungo il percorso da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA." (In genere, gli indirizzi di partenza e di destinazione vengono ricavati dalla cronologia chat).
  • Ricerca basata sulle proprietà dei luoghi: "Ci sono panetterie con una valutazione a stelle di almeno 4 tra San Francisco e 1800 Amphibious Blvd. Mountain View, CA 94045?"
  • Ricerca di percorsi con più tappe: "Sto facendo un viaggio in auto da San Francisco a San Luis Obispo e poi a Los Angeles. Suggeriscimi tre opzioni di caricabatterie EV tra San Francisco e San Luis Obispo e poi tra San Luis Obispo e Los Angeles."

Attiva la ricerca lungo il percorso

La funzionalità di ricerca lungo il percorso richiede le funzionalità Places e Routing per scoprire i luoghi situati lungo un percorso di viaggio. Nell'API REST e negli SDK, entrambi sono attivati per impostazione predefinita per i modelli Gemini 4 e versioni successive quando grounding_types viene omesso. Per i modelli precedenti o se imposti grounding_types, devi includere sia places che routing in grounding_types per attivare la ricerca lungo il percorso.

Comprendi la risposta

Quando un prompt attiva lo strumento Ricerca lungo il percorso, il modello genera una risposta in linguaggio naturale supportata da metadati strutturati che combinano i dati di Places e Routing. In questo modo, le località suggerite sono effettivamente comode rispetto al percorso fisico del viaggio. groundingMetadata conterrà groundingChunks per i luoghi restituiti e il percorso lungo il quale è stata eseguita la ricerca.

Esempio di prompt [Ricerca di un percorso di base]:

Trova stazioni di servizio lungo il percorso da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA.

Esempio di risposta [Ricerca di percorsi di base]:

Ecco alcune stazioni di servizio lungo il percorso da 1800 Amphibious Blvd. Mountain View, CA 94045 a 456 Sunny St, Sunnyvale, CA:

  • Stazione di servizio di esempio - Situata in 123 Example Rd, Sunnyvale, CA 94045. Ha una valutazione di 3, 5 stelle su 122 recensioni e vende idrogeno, propano e benzina, oltre a offrire servizi di autolavaggio. È aperto fino alle 21:50 di stasera e dispone di servizi igienici.
  • Stazione di servizio fittizia: si trova in 456 Fictional Ave, Sunnyvale, CA 94045. Ha una valutazione di 3,6 stelle su 52 recensioni e offre un minimarket e un autolavaggio. Questa stazione è aperta 24 ore su 24 e dispone di bagni.
  • Stazione di servizio generica: si trova in 789 W Generic St, Sunnyvale, CA 94045. Ha una valutazione di 3,6 stelle in base a 35 recensioni. Questa stazione è aperta 24 ore su 24 e dispone di servizi igienici.

Esempio di prompt [Ricerca di un percorso con più tappe]:

Sto per fare un viaggio in auto da San Francisco a San Luis Obispo e poi a Los Angeles. Mi suggerisci tre opzioni di caricabatterie EV tra San Francisco e San Luis Obispo e poi tra San Luis Obispo e Los Angeles?

Esempio di risposta [Ricerca di un percorso con più tappe]:

Ecco alcune opzioni di caricabatterie EV per il tuo viaggio in auto da San Francisco a Los Angeles, con fermate a San Luis Obispo.

Tra San Francisco e San Luis Obispo:

  • Stazione di ricarica di esempio: situata in 123 Example Blvd, Campbell, CA 95008, questa stazione ha una valutazione di 4,5.
  • Stazione EV fittizia: puoi trovare questa stazione all'indirizzo 456 Fictional Rd, Gilroy, CA 95008, con una valutazione di 4,4.
  • Stazione di ricarica generica: questa stazione si trova in 789 Generic St, Salinas, CA 95008 e ha una valutazione di 3, 5.

Tra San Luis Obispo e Los Angeles:

  • Stazione di ricarica di esempio: situata in 123 Example Rd, San Luis Obispo, CA 93123, questa stazione ha una valutazione di 4,3.
  • Stazione di ricarica EV fittizia: questa stazione si trova in 456 Fictional Ave, Santa Barbara, CA 93123, con una valutazione di 3,9.
  • Stazione di ricarica generica: puoi trovare questa stazione all'indirizzo 789 Generic St, Glendale, CA 93123, con una valutazione di 3,0.

Buon viaggio!

Requisiti per l'utilizzo del servizio

Questa sezione descrive i requisiti di utilizzo del servizio per Grounding con Google Maps.

Informare l'utente sull'utilizzo delle fonti di Google Maps

Con ogni Risultato fondato di Google Maps, riceverai fonti in groundingChunks che supportano ogni risposta. Vengono restituiti anche i seguenti metadati:

  • URI di origine
  • titolo
  • ID

Quando presenti i risultati del grounding con Google Maps con Gemini Enterprise Agent Platform, devi specificare le fonti di Google Maps associate e informare gli utenti di quanto segue:

  • Le fonti di Google Maps devono seguire immediatamente i contenuti generati che supportano. Questi contenuti generati sono anche chiamati Risultati fondati di Google Maps.
  • Le fonti di Google Maps devono essere visualizzabili con una sola interazione dell'utente.

Per interfacce basate sulle funzioni vocali

Sourcing: le fonti di Google Maps devono essere visualizzate in una UI complementare che mostra un record storico letterale di qualsiasi conversazione vocale con l'AI. Questo record deve rispettare i requisiti di approvvigionamento ed è soggetto ai limiti di memorizzazione nella cache e archiviazione dei dati applicabili.

Divulgazione attiva delle fonti: gli utenti finali devono essere ragionevolmente informati del ruolo svolto da Google Maps nella loro esperienza e di come trovare informazioni dettagliate sulle fonti al momento dell'interazione.

La divulgazione attiva delle fonti deve comunicare i seguenti punti:

  • I contenuti generati con l'AI potrebbero includere informazioni di Google Maps.

  • Le fonti dettagliate sono disponibili nell'UI complementare.

Devi comunicare la divulgazione attiva delle fonti utilizzando almeno uno dei seguenti metodi.

  • Visualizzazione su schermo: per le interazioni vocali che avvengono su un dispositivo con uno schermo, visualizza l'informativa attiva sullo schermo ogni volta che viene utilizzato Grounding con Google Maps.

  • Annuncio vocale: leggi l'informativa attiva all'utente. Questo deve avvenire durante la prima interazione supportata dal grounding con Google Maps e ripetersi almeno ogni 6 mesi.

Esempio di informativa: "I contenuti generati con l'AI potrebbero includere informazioni di Google Maps. Puoi trovare fonti dettagliate nell'app complementare."

Informativa permanente: l'utente finale deve poter accedere in modo permanente a una spiegazione del fatto che i contenuti di Google Maps potrebbero essere utilizzati nei contenuti generati con l'AI (ad esempio, in un menu delle impostazioni vocali o in un'informativa sull'interazione vocale).

Richieste degli utenti: l'assistente vocale deve rispondere con precisione alle richieste degli utenti finali relative alla fonte dei contenuti, anche quando i contenuti generati con l'AI includono informazioni di Google Maps. Se la fonte è Google Maps, indirizza gli utenti finali all'interfaccia utente complementare per accedere alle informazioni specifiche della fonte.

Per ogni fonte in groundingChunks, deve essere generata un'anteprima del link che soddisfi i seguenti requisiti:

Queste immagini mostrano i requisiti minimi per la visualizzazione delle fonti e dei link a Google Maps.

Prompt con risposta che mostra le fonti

Puoi comprimere la visualizzazione delle fonti.

Prompt con risposta e fonti compresse

(Facoltativo) Migliora l'anteprima del link con contenuti aggiuntivi, ad esempio:

  • Viene inserita una favicon di Google Maps prima dell'attribuzione del testo di Google Maps.
  • Una foto dall'URL di origine (og:image).

Per ulteriori informazioni su alcuni dei nostri fornitori di dati di Google Maps e sui loro termini di licenza, consulta le note legali di Google Maps e Google Earth.

Linee guida per l'attribuzione del testo di Google Maps

Quando attribuisci le fonti a Google Maps nel testo, segui queste linee guida:

  • Non modificare in alcun modo il testo Google Maps:
    • Non modificare l'uso delle maiuscole di Google Maps.
    • Non mandare a capo Google Maps su più righe.
    • Non localizzare Google Maps in un'altra lingua.
    • Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML translate="no".
  • Applica lo stile al testo Google Maps come descritto nella tabella seguente:
Proprietà Stile
Famiglia di caratteri Roboto. Il caricamento del carattere è facoltativo.
Famiglia di caratteri di riserva Qualsiasi carattere sans serif per il corpo già utilizzato nel tuo prodotto o "Sans-Serif" per richiamare il carattere di sistema predefinito
Stile carattere Normale
Spessore carattere 400
Colore carattere Bianco, nero (#1F1F1F) o grigio (#5E5E5E). Mantieni un contrasto accessibile (4,5:1) con lo sfondo.
Dimensione carattere Dimensione minima del carattere: 12 sp
Dimensione massima del carattere: 16 sp
Per scoprire di più sugli sp, consulta le unità di misura delle dimensioni dei caratteri sul sito web di Material Design.
Spaziatura tra le lettere Normale

CSS di esempio

Il seguente CSS esegue il rendering di Google Maps con lo stile e il colore tipografici appropriati su uno sfondo bianco o chiaro.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

ID luogo e ID recensione

I dati di Google Maps includono l'ID luogo e l'ID recensione. Puoi memorizzare nella cache, archiviare ed esportare i seguenti dati di risposta:

  • placeId
  • reviewId

Le limitazioni relative alla memorizzazione nella cache nei Termini di Grounding con Google Maps non si applicano.

Territorio vietato

Il grounding con Google Maps prevede limitazioni per determinati contenuti e attività per mantenere una piattaforma sicura e affidabile. Il Cliente non distribuirà né commercializzerà un'Applicazione del Cliente che offre il Grounding con Google Maps in un Territorio vietato. Per ulteriori informazioni, consulta Territori vietati di Google Maps Platform. L'elenco dei Territori vietati potrebbe essere aggiornato di tanto in tanto.

Fatturazione

Il grounding con Google Maps prevede addebiti per ogni query di Google Maps (consulta la sezione Prezzi).

Una richiesta inviata da un cliente a Gemini può comportare una o più query a Google Maps. Per Gemini 4 e modelli successivi, Places e Routing sono entrambi abilitati quando grounding_types viene omesso, pertanto una richiesta di questo tipo può comportare query di Place Search, Find Directions e Search Along Route. Per limitare una richiesta alle query di Place Search, specifica solo places in grounding_types. La tabella seguente mostra alcuni esempi:

Prompt di esempio Numero potenziale di query di Google Maps Generazione di query di esempio
Ristoranti di sushi vicino all'Hilton Hotel (1335 6th Ave a New York). 3 query di ricerca Place Search (query di Google Maps), supponendo che questo prompt generi 3 query di fanout. 3 query di Place Search con fanout:
- Miglior sushi vicino all'Hilton Midtown Manhattan
- Ristoranti di sushi vicino a 1335 6th Ave New York
- Ristoranti giapponesi vicino a 1335 6th Ave New York
Come faccio ad arrivare a 200 W 44th St, New York dall'Hilton Hotel, 1335 6th Ave. 1 query di ricerca di indicazioni stradali (query di Google Maps) 1 query Trova indicazioni stradali:
- Indicazioni stradali da Hilton Hotel, 1335 6th Ave, New York, NY a 200 W 44th St, New York, NY 10036
Distanza dall'Hilton Hotel (1335 6th Ave a New York) all'aeroporto. 4 query di Google Maps (1 query Place Search + 3 query Find Directions), supponendo che la ricerca dei luoghi restituisca 3 aeroporti. 1 query Place Search con fanout:
- Aeroporti vicino a New York

3 query Find Directions:
- Indicazioni stradali da 1335 6th Ave, New York, NY 10019, USA a John F. Kennedy International Airport, Queens, NY 11430, USA
- Indicazioni stradali da 1335 6th Ave, New York, NY 10019, USA a Newark Liberty International Airport, Newark, NJ 07114, USA
- Indicazioni stradali da 1335 6th Ave, New York, NY 10019, USA a LaGuardia
Trova stazioni di servizio lungo il percorso da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA. 1 query di ricerca lungo il percorso (query di Google Maps) 1 query di ricerca lungo il percorso:
- Stazioni di servizio da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA

Passaggi successivi

  • Per scoprire di più su come eseguire il grounding dei modelli Gemini con i tuoi dati, consulta Grounding con i tuoi dati.
  • Per scoprire di più sulle best practice per l'AI responsabile e sui filtri di sicurezza di Gemini Enterprise Agent Platform, consulta AI responsabile.