Grounding Lite

Google Maps Platform Grounding Lite è un servizio con supporto del Model Context Protocol (MCP) che semplifica la fondatezza delle tue applicazioni AI con dati geospaziali attendibili 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 itinerari: Richiedi informazioni sugli itinerari in auto o a piedi tra due località e restituisci informazioni sulla distanza e la durata dell'itinerario.

L'attivazione del server MCP Maps Grounding Lite consente agli LLM di chiamare i nuovi strumenti esposti dal server per restituire ulteriori informazioni di grounding 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.

Prova l'app di esempio Grounding Lite (si apre in una nuova scheda)

Fatturazione e quote

Prezzi potenziali

L'utilizzo di Grounding Lite non comporta alcun costo durante la fase sperimentale.

Le seguenti tabelle descrivono una potenziale scala dei prezzi per Maps Grounding Lite se viene spostato in disponibilità generale (GA). Per saperne di più, consulta le descrizioni della fase di lancio.

Grounding Lite può essere offerto anche tramite i pacchetti Abbonati e risparmia Essentials e Pro.

I costi sono indicati per 1000 eventi. Tutti i prezzi sono in dollari statunitensi. Gli intervalli si riferiscono al numero di eventi mensili.

Categoria

Nome SKU

Limite di utilizzo senza costi

Limite: 100.000

100.001-500.000

500.001 - 1.000.000

1.000.001-5.000.000

Più di 5.000.000
Essentials Grounding Lite 10.000 7,00 $ 5,95 $ $ 4,90 $3,85 $2,80

Categoria

Nome SKU

Tetto massimo di utilizzo senza costi

Limite: 5.000.000

Più di 5.000.000
Essentials Grounding Lite (India) 70.000 $3,85 $2,80

Quote

Le seguenti quote si applicano agli strumenti forniti da Grounding Lite:

  • 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 del servizio aggiuntivo per Grounding Lite, inclusi i LLM compatibili e i requisiti di attribuzione delle fonti.

Requisiti per i modelli LLM compatibili

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

Ad esempio, sei responsabile di garantire 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 supportano le fonti. 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 di 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:

Configurare gli LLM per l'utilizzo del server MCP

Per utilizzare Grounding Lite, devi prima disporre di un progetto Google Cloud con il servizio API Maps Grounding Lite abilitato, nonché di una chiave API o di un ID client OAuth. A questo punto, puoi configurare i LLM per accedere al server MCP. Il server MCP Grounding Lite utilizza il trasporto HTTP in streaming.

Attiva il servizio Maps Grounding Lite nel tuo progetto Google Cloud

Per abilitare l'API nel tuo progetto:

  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. Abilita Grounding Lite nella libreria API della console Google Cloud.

Autenticarsi utilizzando 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 sia sul progetto Google Cloud sia sulla chiave.

Per eseguire l'autenticazione utilizzando una chiave API:

  1. Crea o configura una chiave API seguendo i passaggi descritti nella sezione Guida introduttiva a Google Maps Platform.
  2. Passa la chiave al server MCP utilizzando l'intestazione X-Goog-Api-Key. Devi specificarlo come intestazione HTTP personalizzata nella configurazione dello strumento MCP del modello LLM.

Esegui l'autenticazione utilizzando OAuth

Puoi autenticarti utilizzando OAuth creando le credenziali OAuth e passandole all'host MCP o all'applicazione server MCP.

Per eseguire l'autenticazione utilizzando OAuth:

  1. Nella console Google Cloud, scegli il progetto che vuoi utilizzare per Grounding Lite.
  2. Nel menu API e servizi, seleziona Credenziali.
  3. Nel menu in alto, seleziona Crea credenziali > ID client OAuth.
  4. Se il progetto non ha una schermata per il consenso configurata, fai clic su Configura schermata per il consenso e segui le istruzioni sullo schermo.
  5. Nella sezione Metriche, fai clic su Crea client OAuth.
  6. Nella schermata Crea ID client OAuth, seleziona un tipo di applicazione e inserisci un nome per l'ID client.
  7. Specifica i dettagli aggiuntivi pertinenti al tipo di richiesta. Ad esempio, se stai creando un'applicazione web, aggiungi URI autorizzati per richieste del browser e del server.
  8. Una volta creato il client, salva l'ID client e il client secret.
  9. Quando configuri l'host MCP o l'applicazione server MCP per accedere a Grounding Lite, trasmetti l'ID client OAuth e il segreto. Devi anche richiedere il seguente ambito: https://www.googleapis.com/auth/maps-platform.mapstools.

Per saperne di più, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Configura i LLM per accedere al server MCP Grounding Lite

Una volta che hai un progetto cloud Google Cloud con il servizio API Maps Grounding Lite attivato e credenziali valide, come una chiave API o un ID client e un secret OAuth, 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

Per saperne di più, consulta Configurare MCP in un'applicazione AI.

Configurare Grounding Lite con Gemini CLI

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

  1. Dopo aver installato Gemini CLI, puoi utilizzare il comando add per configurare il server MCP Maps Grounding Lite:

    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.

Condividere feedback

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