Questa pagina descrive come la funzionalità di fondatezza con Google Maps di Gemini Enterprise Agent Platform può contribuire 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 a informazioni su milioni di località, tra cui attività, punti di riferimento e punti di interesse. Questi dati ti danno accesso a informazioni su oltre 250 milioni di luoghi che possono essere utilizzati per basare le risposte del modello, consentendo alle tue applicazioni e ai tuoi agenti 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 di Grounding con Google Maps
Puoi utilizzare Grounding con Google Maps per varie applicazioni, ad esempio:
- Assistenti conversazionali in grado di rispondere a domande sui luoghi nelle vicinanze, ad esempio "Dov'è il posto più vicino dove posso prendere un espresso italiano?"
- Descrizioni personalizzate e informazioni della community, ad esempio "Puoi dirmi di più sui ristoranti adatti alle famiglie raggiungibili a piedi?"
- Riepiloghi delle aree intorno a posizioni specifiche, come una stazione di ricarica EV o un hotel.
Ciò può essere utile per i casi d'uso in ambito immobiliare, viaggi, mobilità e app di social media.
Modelli supportati
Questa sezione elenca i modelli che supportano Grounding con Google Maps.
Fai clic per espandere i modelli supportati
Per saperne di più sui modelli Gemini, consulta Modelli Gemini.
Utilizzare Grounding con Google Maps per basare le risposte del modello su dati reali
Questo esempio di codice mostra come utilizzare 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:
Nella console Google Cloud , vai alla pagina Agent Studio.
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.
Attiva il pulsante di attivazione/disattivazione di Google Maps.
Fai clic su Applica.
Inserisci il prompt nel campo e fai clic su Invia. Le tue risposte rapide sono alla base di 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 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](/resource-manager/docs/creating-managing-projects#identifiers). .
- MODEL_ID: l'ID modello del modello multimodale.
- PROMPT: il prompt da inviare al modello.
- LATITUDE: la latitudine della posizione. Ad esempio, una latitudine di
37.7749rappresenta San Francisco. Puoi ottenere le coordinate di latitudine e longitudine utilizzando servizi come Google Maps o altri strumenti di geocodifica. - LONGITUDE: la longitudine della posizione. Ad esempio, una longitudine di
-122.4194rappresenta San Francisco. - GROUNDING_TYPES: i tipi di grounding di Google Maps da attivare. Attualmente supporta
placeserouting.places: cerca informazioni sui luoghi, tra cui attività commerciali, punti di interesse importanti e località geografiche.routing: trova indicazioni stradali e cerca lungo il percorso.
places.
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à del luogo
Questa sezione elenca le proprietà dei luoghi utilizzate per descrivere le località e utilizzate da Grounding con Google Maps per generare risposte. Queste proprietà vengono utilizzate per determinare i tipi di domande a cui Grounding con Google Maps può rispondere.
Proprietà del luogo di esempio
Questo elenco fornisce un campionamento alfabetico delle proprietà dei luoghi che possono essere utilizzate dal modello per generare risposte.
- Indirizzo
- Ritiro all'esterno
- Carta di debito
- Distanza
- Parcheggio gratuito
- Musica dal vivo
- Menu per bambini
- Orari di apertura
- Opzioni di pagamento (ad es. contanti o carta di credito)
- Risposta sul luogo
- Animali ammessi
- Serve birra
- Serve cibo vegetariano
- Accessibile in sedia a rotelle
- Wi-Fi
Le risposte sui luoghi sono una risposta di Grounding con Google Maps basata su informazioni derivate dalle recensioni degli utenti.
Esempi di utilizzo delle proprietà dei luoghi
Gli esempi seguenti utilizzano le proprietà dei luoghi nelle domande su diversi tipi di luoghi. Grounding con Google Maps utilizza le proprietà per comprendere la tua intenzione e poi fornisce risposte pertinenti in base ai dati associati ai luoghi in Google Maps.
Organizzare una cena in famiglia: potresti chiedere: "Il ristorante "The Italian Place" è adatto ai bambini e offre il servizio d'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.
Verifica l'accessibilità per un amico: potresti chiedere: Ho bisogno di un ristorante con un ingresso accessibile in sedia a rotelle.
Una risposta a questa richiesta potrebbe aiutarti a determinare se la posizione soddisfa esigenze di accessibilità specifiche.
Trovare un posto per uno spuntino a tarda notte: potresti chiedere, "Burger Joint" è aperto ora? Serve la cena? Quali sono gli orari di apertura per venerdì?
Le risposte a queste domande ti aiutano a trovare un locale aperto che serve un pasto specifico in un determinato momento.
Incontrare un cliente per un caffè: potresti chiedere: "Il "Cafe Central" ha il Wi-Fi?" Servono caffè? Qual è il loro livello di prezzo e accettano carte di credito?
Le risposte a queste domande ti aiutano a valutare l'idoneità di un caffè per una riunione di lavoro in base ai comfort, alle offerte e alle opzioni di pagamento.
Le informazioni nei risultati basati su Google Maps potrebbero differire dalle condizioni effettive della strada.
Comprendere la risposta
Le fonti di Google Maps vengono restituite in groundingMetadata entro
groundingChunks. Le fonti vengono restituite per i luoghi e per le recensioni degli utenti,
che vengono utilizzate per generare il risultato fondato di Google Maps.
Questo esempio di codice mostra una fonte di luogo e una fonte di risposta di luogo nella risposta:
"groundingChunks": [
{
"maps": {
"uri": "{Link to Maps Content}",
"title": "{Name of Maps Place}",
"placeId": "{Place ID}",
"placeAnswerSources": {
"reviewSnippets" : [
{
"reviewId": "{Review ID}",
"googleMapsUri": "{Link to Maps Content}",
"title": "{Title of review}"
}
]
}
},
}
],
Routing - Trova indicazioni stradali
Il grounding con Google Maps supporta la funzionalità Trova indicazioni. Questa funzionalità consente agli agenti AI di comprendere il movimento fisico, le stime di viaggio in tempo reale e le relazioni spaziali tra le posizioni. Con la funzionalità Trova indicazioni stradali, il modello può fornire indicazioni stradali ottimizzate per il rendimento 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 punto a punto e calcolare i tempi di percorrenza stimati per modalità di trasporto specifiche.
Funzionalità
Trova indicazioni calcola distanze e durate di viaggio precise tra origini e destinazioni.
Trovare indicazioni stradali supporta quanto segue:
Mezzi di trasporto: calcolo itinerario per auto, a piedi, in bicicletta, con i mezzi pubblici e con veicoli motorizzati a due ruote (non tutte le modalità di viaggio 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:
Vicinanza in base al tempo di percorrenza: "Quali sono alcuni ristoranti americani raggiungibili a piedi in 10 minuti dall'Hilton Hotel in 1335 6th Ave a New York?"
Stima del tragitto: "Quanto tempo ci vuole per prendere i mezzi pubblici da Pike Place Market a Capitol Hill a Seattle?"
Comprendere la risposta
Quando un prompt attiva la funzionalità Trova indicazioni, il modello genera una risposta in linguaggio naturale supportata da metadati strutturati. In questo modo, puoi mostrare all'utente informazioni di viaggio precise.
I seguenti dati vengono restituiti in una risposta payload:
Durata: il tempo necessario per spostarsi tra le località, tenendo conto del traffico, se richiesto. Ad esempio, "500 secondi".
Distanza: la distanza fisica del percorso. Ad esempio, "1,9 km".
Polilinea: una stringa di testo codificata che consente di visualizzare visivamente il percorso specifico su una mappa.
Di seguito è riportato un esempio di risposta al prompt: "Come faccio ad arrivare al ristorante Carmine's dall'hotel Hilton (1335 6th Ave a New York) dove alloggio?"
Per raggiungere il ristorante Carmine's dall'Hilton Hotel in 1335 6th Ave a New York, devi recarti nella sede di Carmine's a Times Square in 200 W 44th St, New York, NY 10036, Stati Uniti.
Ecco le indicazioni a piedi:
Inizia dall'Hilton Hotel: esci dall'Hilton Hotel in 1335 6th Ave.
Cammina verso sud su 6th Avenue: procedi verso sud su 6th Avenue (Avenue of the Americas) in direzione di W 44th Street.
Svolta a destra su W 44th Street: svolta a destra su W 44th Street.
Carmine's si trova sulla sinistra: percorri W 44th Street e troverai Carmine's sulla sinistra al civico 200 di W 44th St.
Questo percorso a piedi è lungo circa 800 metri e dovrebbe richiedere circa 10-15 minuti.
Di seguito è riportato un esempio di risposta al prompt: "Quanto tempo ci vuole per prendere i mezzi pubblici dal Pikes Place Market a Capitol Hill a Seattle?"
Per andare dal Pike Place Market a Capitol Hill a Seattle con i mezzi pubblici, hai a disposizione due opzioni:
Tram (metrotramvia): il tram da Westlake, vicino al Pike Place Market, a Capitol Hill impiega circa 3 minuti. Inclusi i trasferimenti, il tempo di percorrenza totale è di circa 9 minuti, con i tram che partono ogni 10 minuti.
Autobus: un autobus diretto King County Metro da Pike St e 4th Ave (vicino al 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
Cerca lungo il percorso consente agli agenti di AI di scoprire punti di interesse geograficamente pertinenti e comodi per il viaggio pianificato di un utente. Basando le risposte sui motori di ricerca spaziale e di pianificazione degli itinerari di Google Maps, il modello può fornire consigli che riducono al minimo le deviazioni e comprendere il flusso logistico di un viaggio on the road o di un tragitto.
Funzionalità
La funzionalità Cerca lungo il percorso consente all'applicazione di identificare attività, servizi o attrazioni specifici situati direttamente lungo un percorso generato tra un'origine e una destinazione. È supportata solo la modalità di viaggio "Auto".
Gli esempi seguenti illustrano i tipi di domande che lo strumento Cerca lungo il percorso può gestire.
- Ricerca di base del percorso: "Trova stazioni di servizio lungo la strada da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA." (In genere, gli indirizzi di origine e destinazione vengono ricavati dalla cronologia chat.)
- Cerca in base alle proprietà del luogo: "Ci sono panetterie con almeno 4 stelle tra San Francisco e 1800 Amphibious Blvd, Mountain View, CA 94045?"
- Ricerca di itinerari con più tappe: "Sto organizzando 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".
Comprendere la risposta
Quando un prompt attiva lo strumento Cerca lungo il percorso, il modello genera una
risposta in linguaggio naturale supportata da metadati strutturati che combinano dati di Places
e di Routing. In questo modo, le posizioni suggerite sono effettivamente comode
per il percorso fisico del viaggio. groundingMetadata conterrà
groundingChunks per i luoghi restituiti e l'itinerario cercato.
Esempio di prompt [ricerca di un percorso di base]:
Trova stazioni di servizio lungo la strada da 1800 Amphibious Blvd. Mountain View, CA 94045, a 456 Sunny St, Sunnyvale CA.
Esempio di risposta [ricerca di base dell'itinerario]:
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: si trova al civico 123 di Example Rd, Sunnyvale, CA 94045. Ha una valutazione di 3, 5 stelle su 122 recensioni e vende idrogeno, propano e benzina, oltre a servizi di autolavaggio. È aperto fino alle 21:50 di stasera e dispone di servizi igienici.
- Stazione di servizio fittizia: si trova al 456 di 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 al giorno e dispone di servizi igienici.
- Stazione di servizio generica: si trova al 789 di 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.
Testo di esempio [ricerca di un itinerario con più tappe]:
Sto per fare 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.
Esempio di risposta [ricerca di itinerario con più tappe]:
Ecco alcune opzioni di caricabatterie EV per il tuo viaggio in auto da San Francisco a Los Angeles, con soste a San Luis Obispo.
Tra San Francisco e San Luis Obispo:
- Esempio di stazione di ricarica: situata al 123 Example Blvd, Campbell, CA 95008, questa stazione ha una valutazione di 4,5.
- Stazione di ricarica per veicoli elettrici 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 al civico 789 di Generic St, Salinas, CA 95008 e ha una valutazione di 3, 5.
Tra San Luis Obispo e Los Angeles:
- Esempio di stazione di ricarica: situata al civico 123 di Example Rd, San Luis Obispo, CA 93123, questa stazione ha una valutazione di 4,3.
- Stazione di ricarica per veicoli elettrici fittizia: questa stazione si trova al 456 di 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.
Informa l'utente dell'utilizzo delle fonti di Google Maps
Per ogni risultato basato su Google Maps, riceverai fonti in
groundingChunks che supportano ogni risposta. Vengono restituiti anche i seguenti metadati:
- source uri
- titolo
- ID
Quando presenti i risultati di 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 le fonti. Questi contenuti generati sono anche chiamati Risultato fondato di Google Maps.
- Le fonti di Google Maps devono essere visualizzabili con una sola interazione dell'utente.
Per interfacce vocali
Fonti:le fonti di Google Maps devono essere visualizzate in un'interfaccia utente complementare che mostri una registrazione storica letterale di qualsiasi conversazione con la voce AI. Questo record deve rispettare i requisiti di origine ed è soggetto ai limiti di memorizzazione nella cache e archiviazione dei dati applicabili.
Divulgazione attiva delle fonti: gli utenti finali devono essere ragionevolmente consapevoli del ruolo che Google Maps svolge nella loro esperienza e di come trovare informazioni dettagliate sulle fonti al momento dell'interazione.
La divulgazione attiva delle fonti deve trasmettere i seguenti punti:
I contenuti generati dall'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: per le interazioni vocali che si verificano su un dispositivo con uno schermo, mostra l'informativa attiva sullo schermo ogni volta che viene utilizzata la funzionalità di localizzazione con Google Maps.
Annuncio vocale:leggi l'informativa attiva all'utente. Questa operazione deve avvenire durante la prima interazione supportata da Grounding con Google Maps e ripetersi almeno ogni 6 mesi.
Esempio di informativa: "I contenuti generati dall'AI possono includere informazioni provenienti da Google Maps. Puoi trovare le fonti dettagliate nell'app complementare."
Informativa persistente:una spiegazione che indichi che i contenuti di Google Maps potrebbero essere utilizzati nei contenuti generati dall'AI deve essere accessibile in modo permanente all'utente finale (ad es. in un menu delle impostazioni vocali o in un'informativa sull'interazione vocale).
Query degli utenti:l'assistente vocale deve rispondere con precisione alle query degli utenti finali in merito all'origine dei contenuti, anche quando i contenuti generati con l'AI includono informazioni di Google Maps. Se Google Maps è la fonte, indirizza gli utenti finali all'interfaccia utente complementare per accedere a informazioni specifiche sulla fonte.
Visualizzare le fonti di Google Maps con i link di Google Maps
Per ogni origine in groundingChunks e in
grounding_chunks.maps.placeAnswerSources.reviewSnippets, deve essere generata
un'anteprima del link in base ai seguenti requisiti:
- Attribuisci ogni fonte a Google Maps seguendo le linee guida per l'attribuzione del testo di Google Maps.
- Mostra il titolo della fonte fornito nella risposta.
- Link alla fonte utilizzando
uriogoogleMapsUridalla risposta.
Queste immagini mostrano i requisiti minimi per la visualizzazione delle fonti e dei link di Google Maps.
Puoi comprimere la visualizzazione delle fonti.
(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 relativi termini di licenza, consulta le note legali di Google Maps e Google Earth.
Linee guida per l'attribuzione di 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 le maiuscole di Google Maps.
- Non mandare a capo Google Maps.
- Non localizzare Google Maps in un'altra lingua.
- Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML
translate="no".
- Formatta il 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 del corpo sans-serif 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). Mantenere un contrasto accessibile (4,5:1) rispetto allo sfondo. |
| Dimensione carattere | Dimensione carattere minima: 12 sp Dimensione carattere massima: 16 sp Per scoprire di più su sp, consulta Unità di dimensione carattere sul sito web Material Design. |
| Spaziatura tra le lettere | Normale |
CSS di esempio
Il seguente CSS esegue il rendering di Google Maps con lo stile tipografico e il colore 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. Potresti memorizzare nella cache, archiviare ed esportare i seguenti dati delle risposte:
placeIdreviewId
Le limitazioni alla memorizzazione nella cache nei Termini del grounding con Google Maps non si applicano.
Territorio vietato
La funzionalità di grounding con Google Maps presenta 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 la pagina 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 (vedi Prezzi).
Una richiesta inviata da un cliente a Gemini può generare una o più query a Google Maps. La seguente tabella 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 Place Search (query di Google Maps), supponendo che questo prompt generi 3 query di fanout. | 3 query di ricerca di fanout di Place Search: - Best sushi near Hilton Midtown Manhattan - Sushi restaurants near 1335 6th Ave New York - Japanese restaurants near 1335 6th Ave New York |
| Come faccio ad arrivare al 200 W 44th St, New York dall'Hilton Hotel, 1335 6th Ave. | 1 query Trova indicazioni stradali (query di Google Maps) | 1 Query Trova indicazioni: - 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 di Place Search + 3 query di ricerca di indicazioni stradali), supponendo che la ricerca del luogo restituisca 3 aeroporti. | 1 query di ricerca Place Search fanout: - Aeroporti vicino a New York 3 query Trova indicazioni: - Indicazioni stradali da 1335 6th Ave, New York, NY 10019, USA a John F. Kennedy International Airport, Queens, NY 11430, USA - Indicazioni da 1335 6th Ave, New York, NY 10019, USA a Newark Liberty International Airport, Newark, NJ 07114, USA - Indicazioni da 1335 6th Ave, New York, NY 10019, USA a LaGuardia |
| Trova stazioni di servizio lungo la strada da 1800 Amphibious Blvd, Mountain View, CA 94045 a 456 Sunny St, Sunnyvale CA. | 1 query Cerca lungo il percorso (query di Google Maps) | 1 query Cerca 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 basare i modelli Gemini sui tuoi dati, consulta Grounding con i tuoi dati.
- Per saperne di più sulle best practice per l'AI responsabile e sui filtri di sicurezza di Gemini Enterprise Agent Platform, consulta AI responsabile.