Questa pagina descrive come Grounding con Google Maps con Vertex AI può aiutarti a migliorare le tue applicazioni di AI generativa fornendo un contesto geospaziale.
Panoramica
Grounding con Google Maps con Vertex AI è un servizio che connette i modelli Gemini con 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 luoghi specifici, 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.
Gemini 3 Pro e Gemini 3 Pro Image sono limitati a 5000 query di ricerca al giorno.
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. Per saperne di più, consulta l'API Grounding.
Console
Per utilizzare Grounding con Google Maps con Vertex AI:
Nella console Google Cloud , vai alla pagina Vertex AI Studio.
Nella sezione Strumenti, fai clic su Grounding: Google. Viene visualizzato un riquadro di configurazione.
Per utilizzare Google Maps, fai clic sul pulsante di attivazione/disattivazione Google Maps.
Fai clic su Applica.
Inserisci il prompt nel campo e fai clic su Invia. Le tue risposte rapide a 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 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_VERTEXAI=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(
enable_widget=False # Optional: return Maps widget token
))
],
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 come globale.
- PROJECT_ID: il tuo ID progetto
- 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. - ENABLE_WIDGET: indica se restituire un token e attivare il widget Google Maps (il valore predefinito è
false).
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": {
"enableWidget": "ENABLE_WIDGET"
}
}],
"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
]
},
],
"googleMapsWidgetContextToken": "widgetcontent/..."
}
}
],
...
}
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 sui luoghi
- 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à del luogo
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: "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 comodo.
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? Servono 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 dati reali di 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 sono state utilizzate per contribuire a generare il risultato basato su dati reali 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
Il grounding con Google Maps supporta le funzionalità di calcolo dell'itinerario. 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. Basando le risposte sul motore di pianificazione degli itinerari di Google Maps, il modello può fornire indicazioni ottimizzate per il rendimento e tempi di percorrenza accurati che tengono conto delle condizioni in tempo reale. Questa integrazione consente a Grounding con Google Maps di filtrare i luoghi in base al tempo di percorrenza, offrire indicazioni stradali precise da punto a punto e calcolare i tempi di spostamento stimati per modalità di trasporto specifiche.
Le funzionalità di routing sono disponibili come anteprima con limitazioni. Per accedere a questa funzionalità per il tuo progetto, contatta il team dedicato all'account per richiedere l'aggiunta alla lista consentita. Google Cloud In alternativa, puoi inviare il modulo di partecipazione per essere preso in considerazione. Google sta accettando manifestazioni di interesse da un gruppo limitato di partner per testare lo strumento Grounding con Google Maps Routing.
Funzionalità
Lo strumento Routing calcola distanze e durate di viaggio precise tra origini e destinazioni.
Lo strumento di routing supporta quanto segue:
Mezzi di trasporto: itinerari 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 tappe 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 dallo strumento di routing:
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 lo strumento di routing, 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 del 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 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 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 sulla 6th Avenue: procedi verso sud sulla 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 Pike Place Market a Capitol Hill a Seattle?"
Per andare da 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.
Cerca lungo il percorso
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 di routing e spaziali di Google Maps, il tuo 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.
Le funzionalità di Cerca lungo il percorso sono disponibili come anteprima con limitazioni. Per accedere a questa funzionalità per il tuo progetto, contatta il team dedicato al tuo account Google Cloud per richiedere l'aggiunta alla lista consentita. In alternativa, puoi anche inviare questo modulo per essere preso in considerazione per la partecipazione. Tieni presente che al momento accettiamo l'interesse di una coorte limitata di partner solo per testare lo strumento Grounding con Google Maps Search Along Route.
Funzionalità
La funzionalità Cerca lungo il percorso consente alla tua applicazione di identificare attività, servizi o attrazioni specifiche situate direttamente lungo un percorso generato tra un punto di partenza e una destinazione. Nella preview è supportata solo la modalità di viaggio "In 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 panifici 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 il percorso 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.
Risposta di esempio [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 numero 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 offrire servizi di autolavaggio. È aperto fino alle 21:50 di questa sera 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 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 on the road 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 Vertex AI, 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 basato su dati reali di Google Maps.
- Le fonti di Google Maps devono essere visualizzabili in 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 sourcing ed è soggetto ai limiti di memorizzazione nella cache e archiviazione dei dati applicabili.
Divulgazione attiva delle fonti: gli utenti finali devono essere resi 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 utilizzato il Grounding 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 potrebbero includere informazioni di 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).
Domande degli utenti: l'assistente vocale deve rispondere con precisione alle domande degli utenti finali riguardo alla fonte dei contenuti, anche quando i contenuti generati dall'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 sorgente 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 del carattere | 400 |
| Colore carattere | Bianco, nero (#1F1F1F) o grigio (#5E5E5E). Mantenere un contrasto accessibile (4,5:1) rispetto allo sfondo. |
| Dimensione carattere | Dimensioni carattere minime: 12 sp Dimensioni carattere massime: 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 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;
}
Token di contesto, ID luogo e ID recensione
I dati di Google Maps includono token di contesto, ID luogo e ID recensione. Potresti memorizzare nella cache, archiviare ed esportare i seguenti dati delle risposte:
googleMapsWidgetContextTokenplaceIdreviewId
Le limitazioni alla memorizzazione nella cache previste dai 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 Grounding con Google Maps in un Territorio vietato. Per ulteriori informazioni, consulta la pagina Territori vietati di Google Maps Platform. L'elenco dei Territori non ammessi potrebbe essere aggiornato di tanto in tanto.
(Facoltativo) Widget contestuale di Google Maps
Il widget contestuale è un'offerta pre-GA di Google Maps che funge da contenitore visivo
utilizzato per supportare o integrare altri contenuti di Google Maps. Il
widget contestuale di Google Maps ti consente di integrare Grounding con Google Maps
nelle tue applicazioni per creare un'esperienza di chat conversazionale basata su LLM.
Il widget contestuale viene visualizzato utilizzando il token di contesto,
googleMapsWidgetContextToken, restituito nella
risposta dell'API Vertex AI e può essere utilizzato per visualizzare contenuti visivi.
Il widget contestuale svolge diverse funzioni a seconda dello scenario:
Mostra recensioni e foto degli utenti, ovvero contenuti generati dagli utenti, nello scenario in cui viene utilizzato il prompt di Google Maps per la generazione di risposte.
Consente di arricchire i risultati con visualizzazioni e dati della mappa quando Vertex AI genera solo una risposta di testo.
Per ulteriori informazioni sul widget contestuale, vedi Widget di grounding di Maps.
Esegui il rendering del widget contestuale di Google Maps
Per eseguire il rendering e utilizzare il widget contestuale di Google Maps, utilizza la versione alpha dell'API Maps JavaScript nella pagina che mostra il widget. Per saperne di più, consulta Caricare l'API Maps JavaScript.
I seguenti esempi di codice mostrano come utilizzare un widget contestuale:
Crea un widget contestuale.
<body> <gmp-place-contextual id="widget"></gmp-place-contextual> </body>In qualsiasi risposta basata su Google Maps, è presente un
googleMapsWidgetContextTokencorrispondente utilizzato per il rendering del widget contestuale, posizionato in prossimità della risposta generata.Per aggiornare il token di contesto, imposta
widget.contextToken property."googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>... Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",function updateWidget(contextToken) { let widget = document.querySelector('#widget'); widget.contextToken = contextToken; }(Facoltativo) Specifica il layout dell'elenco. I valori validi includono:
- Layout compatto:
<gmp-place-contextual-list-config layout="compact"> - Layout verticale:
<gmp-place-contextual-list-config layout="vertical">
Questo esempio di codice mostra come modificare il layout elenco in un layout compatto.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config layout="compact"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Layout compatto:
(Facoltativo) Cambia la modalità mappa. I valori validi includono:
- Mappa della roadmap 2D:
map-mode="roadmap" - Mappa ibrida 3D:
map-mode="hybrid" - Nessuna mappa:
map-mode="none"
Questo esempio di codice mostra come passare alla modalità mappa 2D.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config map-mode="roadmap"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Mappa della roadmap 2D:
Passaggi successivi
- Per scoprire di più su come basare i modelli Gemini sui 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 Vertex AI, consulta AI responsabile.