Grounding Lite

Sperimentale: Grounding Lite è in fase sperimentale (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per maggiori informazioni, consulta le descrizioni della fase di lancio. Non è previsto alcun addebito per l'utilizzo di Grounding Lite durante la fase sperimentale.

Google Maps Platform Grounding Lite è un servizio con supporto del protocollo di contesto del modello (MCP) che semplifica la fondatezza delle tue applicazioni di AI con dati geospaziali affidabili di Google Maps. Il server MCP fornisce strumenti che consentono ai LLM di accedere alle funzionalità per luoghi, meteo e itinerari. Puoi provare Grounding Lite attivandolo in qualsiasi strumento che supporta i server MCP.

Strumenti

Grounding Lite fornisce strumenti che consentono ai LLM di accedere alle seguenti funzionalità di Google Maps:

• Cerca luoghi: richiedi informazioni sui luoghi e ottieni riepiloghi dei dati sui luoghi generati dall'AI, nonché ID luogo, coordinate di latitudine e longitudine e link di Google Maps per ciascuno dei luoghi inclusi nel riepilogo. Puoi utilizzare gli ID luogo e le coordinate di latitudine e longitudine restituiti con altre API di Google Maps Platform per mostrare i luoghi su una mappa.
• Cerca meteo: richiedi informazioni sul meteo e restituisci le condizioni attuali, le previsioni orarie e le previsioni giornaliere.

• Calcola percorsi: richiedi informazioni sui percorsi in auto o a piedi tra due località e restituisci informazioni su distanza e durata del percorso.

  Nota: Grounding Lite non fornisce itinerari passo passo, indicazioni stradali, traffico in tempo reale o informazioni di navigazione

L'attivazione del server MCP Maps Grounding Lite consente agli LLM di chiamare i nuovi strumenti esposti dal server per restituire informazioni di grounding aggiuntive per i tipi di dati elencati sopra. Sebbene l'LLM possa utilizzare queste informazioni aggiuntive per il contesto, la risposta che genera alla fine potrebbe non includere le informazioni esatte restituite dal server MCP. Devi verificare l'accuratezza della risposta generata.

Fatturazione e quote

L'utilizzo di Grounding Lite non comporta alcun costo durante la fase sperimentale. Tuttavia, alle funzionalità fornite da Grounding Lite si applicano le seguenti quote:

• Cerca luoghi: 100 query al minuto per progetto. 1000 query al giorno per progetto.
• Cerca meteo: 300 query al minuto per progetto.
• Compute Routes: 300 query al minuto per progetto.

Norme e Termini di servizio

Grounding Lite è soggetto ai Termini di servizio di Google Maps Platform, inclusi i termini specifici del servizio per questo servizio. Questa sezione descrive i requisiti di utilizzo aggiuntivi per Grounding Lite, inclusi i LLM compatibili e i requisiti di attribuzione delle fonti.

Requisiti per i LLM compatibili

Puoi utilizzare Grounding Lite solo con un LLM conforme ai Termini di servizio di Google Maps Platform.

Ad esempio, è tua responsabilità assicurarti che i contenuti di Google Maps non vengano memorizzati nella cache, archiviati o utilizzati per migliorare il modello linguistico di grandi dimensioni che scegli di utilizzare. Prima di utilizzare Grounding Lite, devi esaminare i Termini di servizio di qualsiasi modello che intendi utilizzare con Grounding Lite. Non devi utilizzare Grounding Lite con modelli che utilizzano i dati inseriti nel modello per l'addestramento o il miglioramento del modello. È tua responsabilità assicurarti che l'utilizzo del modello sia pienamente conforme alle limitazioni relative ai contenuti di Google Maps nei Termini di servizio di Google Maps Platform, inclusi i termini specifici del servizio.

Requisiti di attribuzione per le fonti di Google Maps

Ogni risposta dello strumento Grounding Lite include le fonti. Quando presenti risultati che utilizzano strumenti forniti da Grounding Lite, devi includere le fonti di Google Maps associate in modo da soddisfare i seguenti requisiti:

• Le fonti di Google Maps devono seguire immediatamente i contenuti generati che le fonti supportano. Questi contenuti generati sono anche chiamati output fondato.
• Le fonti di Google Maps devono essere visualizzabili in una sola interazione dell'utente.

Fonti per lo strumento Cerca luoghi

Il campo places dello strumento search_places fornisce fonti a sostegno del summary. Per places, vengono restituiti i seguenti metadati:

• place (nome della risorsa)
• id
• location
• googleMapsLinks

Per ogni luogo, devi generare un'anteprima del link che soddisfi i seguenti requisiti:

• Attribuisci ogni fonte a Google Maps, seguendo le linee guida per l'attribuzione del testo Grounding Lite.
• Mostra il titolo della pagina di origine dai metadati Open Graph og:title di googleMapsLinks forniti nella risposta.
• Collega la fonte utilizzando places.googleMapsLinks.placeUrl dalla risposta.

Configurare gli LLM per l'utilizzo del server MCP

Per utilizzare Grounding Lite, devi prima disporre di una chiave API con il servizio API Maps Grounding Lite abilitato. A questo punto, puoi configurare i LLM per accedere al server MCP. Il server Grounding Lite MCP utilizza il trasporto HTTP in streaming.

Creare o configurare una chiave API

Puoi utilizzare una chiave API esistente con Maps Grounding Lite o crearne una nuova, a condizione che tu abiliti il servizio API Maps Grounding Lite sulla chiave. L'API Maps Grounding Lite non prevede addebiti durante la fase sperimentale, ma la fatturazione deve essere abilitata nel progetto.

Per abilitare l'API:

1. Nella console Google Cloud, scegli il progetto che vuoi utilizzare per Grounding Lite.
2. Abilita la fatturazione per il progetto nella console Google Cloud.
3. Dalla navigazione in alto, apri il terminale Cloud Shell.

4. Esegui questi comandi per abilitare il servizio e l'endpoint MCP:

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

5. Segui i passaggi descritti in Guida introduttiva a Google Maps Platform per creare o configurare una chiave API.

Nota: quando crei o configuri una chiave API, assicurati di limitarne l'utilizzo applicando le limitazioni appropriate. Per saperne di più, consulta Limitare le chiavi API.

La chiave API deve essere trasmessa al server MCP utilizzando l'intestazione X-Goog-Api-Key. Devi specificarlo come intestazione HTTP personalizzata nella configurazione dello strumento MCP dell'LLM.

Configurare i LLM per accedere al server MCP Grounding Lite

Una volta ottenuta una chiave API con il servizio API Maps Grounding Lite attivato, puoi configurare i LLM per accedere al server MCP seguendo la documentazione di configurazione MCP corrispondente e utilizzando l'URL del server MCP Grounding Lite: https://mapstools.googleapis.com/mcp

Configurare Grounding Lite con Gemini CLI

Questa sezione fornisce un esempio di come configurare il server Grounding Lite MCP utilizzando la CLI Gemini. Per maggiori dettagli, consulta Server MCP con la CLI Gemini.

1. Dopo aver installato l'interfaccia a riga di comando di Gemini, puoi utilizzare il comando add per configurare il server Maps Grounding Lite MCP:

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   Se la configurazione è andata a buon fine, dovresti visualizzare una conferma che il server è stato aggiunto alle impostazioni utente.

2. Per verificare che il server funzioni correttamente, esegui il comando /mcp list:

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. Inizia a porre domande relative a Maps con l'interfaccia a riga di comando. Ad esempio, prova a dire "Consigliami dei ristoranti a Mountain View", che dovrebbe chiamare lo strumento search_places per tuo conto.

Condivisione di feedback

Per condividere il tuo feedback su Grounding Lite, utilizza i seguenti moduli:

• Segnala un bug
• Invia una richiesta di funzionalità
• Inviare un feedback