Grounding Lite

Google Maps Platform Grounding Lite ist ein Dienst mit Unterstützung für das Model Context Protocol (MCP), mit dem Sie Ihre KI-Anwendungen ganz einfach mit vertrauenswürdigen geografischen Daten aus Google Maps verknüpfen können. Der MCP-Server bietet Tools, mit denen LLMs auf Funktionen für Orte, Wetter und Routen zugreifen können. Sie können Grounding Lite testen, indem Sie es in einem beliebigen Tool aktivieren, das MCP-Server unterstützt.

Grounding Lite bietet Tools, mit denen LLMs auf die folgenden Google Maps-Funktionen zugreifen können:

• Orte suchen: Sie können Informationen zu Orten anfordern und KI-generierte Zusammenfassungen von Ortsdaten abrufen, sowie Orts-IDs, Koordinaten für Breiten- und Längengrad und Google Maps Links für jeden in der Zusammenfassung enthaltenen Ort. Sie können die zurückgegebenen Orts-IDs und Koordinaten für Breiten- und Längengrad mit anderen Google Maps Platform APIs verwenden, um Orte auf einer Karte anzuzeigen.
• Wetter abrufen: Sie können Informationen zum Wetter anfordern und aktuelle Bedingungen, stündliche Vorhersagen und Tagesvorhersagen abrufen.

• Routen berechnen: Sie können Informationen zu Routen für Autofahrer oder Fußgänger zwischen zwei Orten anfordern und Informationen zur Routenentfernung und -dauer abrufen.

Wenn Sie den Maps Grounding Lite MCP-Server aktivieren, können LLMs die neuen Tools aufrufen, die vom Server bereitgestellt werden, um zusätzliche Informationen für die oben aufgeführten Datentypen zurückzugeben. LLMs können diese zusätzlichen Informationen zwar für den Kontext verwenden, die von ihnen generierte Antwort enthält aber möglicherweise nicht die genauen Informationen, die vom MCP-Server zurückgegeben wurden. Sie sollten die Richtigkeit der generierten Antwort überprüfen.

Beispiel-App für Grounding Lite testen (in neuem Tab öffnen)

Abrechnung und Kontingente

Mögliche Preise

Die Verwendung von Grounding Lite ist während der experimentellen Phase kostenlos.

In den folgenden Tabellen wird eine mögliche Preisskala für Maps Grounding Lite beschrieben, falls der Dienst allgemein verfügbar wird. Weitere Informationen finden Sie unter den Beschreibungen der Markteinführungsphase.

Grounding Lite wird möglicherweise auch über die Pakete „Essentials“ und „Pro Subscribe to save “ angeboten.

Die Kosten sind pro 1.000 Ereignisse angegeben. Alle Preise sind in US-Dollar angegeben. Die Bereiche beziehen sich auf die Anzahl der monatlichen Ereignisse.

Kategorie	Name der Artikelnummer	Obergrenze für kostenlose Nutzung	Obergrenze – 100.000	100.001–500.000	500.001–1.000.000	1.000.001–5.000.000	Über 5.000.000
Essentials	Grounding Lite	10.000	7,00 $	5,95 $	4,90 $	3,85 $	2,80 $

Kategorie	Name der Artikelnummer	Obergrenze für kostenlose Nutzung	Obergrenze – 5.000.000	Über 5.000.000
Essentials	Grounding Lite (Indien)	70.000	3,85 $	2,80 $

Kontingente

Die folgenden Kontingente gelten für die von Grounding Lite bereitgestellten Tools:

• Orte suchen: 100 Abfragen pro Minute und Projekt 1.000 Abfragen pro Tag und Projekt
• Wetter abrufen: 300 Abfragen pro Minute und Projekt
• Routen berechnen: 300 Abfragen pro Minute und Projekt

Richtlinien und Nutzungsbedingungen

Für Grounding Lite gelten die Nutzungsbedingungen für die Google Maps Platform, einschließlich der dienstspezifischen Nutzungsbedingungen für diesen Dienst. In diesem Abschnitt werden zusätzliche Anforderungen an die Nutzung von Grounding Lite beschrieben, einschließlich kompatibler LLMs und Anforderungen an die Quellenangabe.

Anforderungen an kompatible LLMs

Sie dürfen Grounding Lite nur mit einem LLM verwenden, das den Nutzungsbedingungen für die Google Maps Platform entspricht.

Sie sind beispielsweise dafür verantwortlich, dass Google Maps-Inhalte nicht vom LLM, das Sie verwenden, im Cache gespeichert oder zur Verbesserung des LLM verwendet werden. Bevor Sie Grounding Lite verwenden, müssen Sie die Nutzungsbedingungen für alle Modelle lesen, die Sie mit Grounding Lite verwenden möchten. Sie dürfen Grounding Lite nicht mit Modellen verwenden, bei denen die in das Modell eingegebenen Daten für das Training oder die Verbesserung des Modells verwendet werden. Sie sind dafür verantwortlich, dass Ihre Verwendung des Modells vollständig den Einschränkungen für Google Maps-Inhalte in den Nutzungsbedingungen für die Google Maps Platform entspricht, einschließlich der dienstspezifischen Nutzungsbedingungen.

Anforderungen an die Quellenangabe für Google Maps-Quellen

Jede Toolantwort von Grounding Lite enthält Quellen. Wenn Sie Ergebnisse präsentieren, die Tools von Grounding Lite verwenden, müssen Sie die zugehörigen Google Maps-Quellen so angeben, dass die folgenden Anforderungen erfüllt sind:

• Die Google Maps-Quellen müssen direkt auf die generierten Inhalte folgen, die sie unterstützen. Diese generierten Inhalte werden auch als Grounded Output bezeichnet.
• Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.

Quellen für das Tool „Orte suchen“

Das Feld places des Tools search_places enthält Quellen, die die summary unterstützen. Für places werden die folgenden Metadaten zurückgegeben:

• place (Ressourcenname)
• id
• location
• googleMapsLinks

Für jeden Ort müssen Sie eine Linkvorschau erstellen, die die folgenden Anforderungen erfüllt:

• Geben Sie für jede Quelle Google Maps als Quelle an und folgen Sie dabei den Richtlinien für die Quellenangabe für Grounding Lite.
• Verlinken Sie die Quelle mit places.googleMapsLinks.placeUrl aus der Antwort.

LLMs für die Verwendung des MCP-Servers konfigurieren

Wenn Sie Grounding Lite verwenden möchten, benötigen Sie zuerst ein Google Cloud-Projekt, in dem der API-Dienst Maps Grounding Lite aktiviert ist, sowie einen API-Schlüssel oder eine OAuth-Client-ID. Anschließend können Sie LLMs für den Zugriff auf den MCP-Server konfigurieren. Der Grounding Lite MCP-Server verwendet den streamfähigen HTTP-Transport.

Dienst Maps Grounding Lite in Ihrem Google Cloud-Projekt aktivieren

So aktivieren Sie die API in Ihrem Projekt:

1. Wählen Sie in der Google Cloud Console das Projekt aus, das Sie für Grounding Lite verwenden möchten.
2. Aktivieren Sie die Abrechnung für das Projekt in der Google Cloud Console.
3. Aktivieren Sie Grounding Lite in der Google Cloud Console API-Bibliothek.

Authentifizierung mit einem API-Schlüssel

Sie können einen vorhandenen API-Schlüssel mit Maps Grounding Lite verwenden oder einen neuen erstellen, so fern Sie den Maps Grounding Lite API Dienst sowohl im Google Cloud-Projekt als auch für den Schlüssel aktivieren.

So authentifizieren Sie sich mit einem API-Schlüssel:

1. Erstellen oder konfigurieren Sie einen API-Schlüssel. Folgen Sie dazu der Anleitung unter Erste Schritte mit der Google Maps Platform.
2. Übergeben Sie den Schlüssel mit dem Header X-Goog-Api-Key an den MCP-Server. Sie müssen dies als benutzerdefinierten HTTP-Header in der MCP-Toolkonfiguration des LLM angeben.

Authentifizierung mit OAuth

Sie können sich mit OAuth authentifizieren, indem Sie OAuth-Anmeldedaten erstellen und sie an die MCP-Host- oder MCP-Serveranwendung übergeben.

So authentifizieren Sie sich mit OAuth:

1. Wählen Sie in der Google Cloud Console das Projekt aus, das Sie für Grounding Lite verwenden möchten.
2. Wählen Sie im Menü APIs &Dienste die Option Anmeldedaten aus.
3. Wählen Sie im oberen Menü Anmeldedaten erstellen > OAuth-Client-ID aus.
4. Wenn für das Projekt kein Zustimmungsbildschirm konfiguriert ist, klicken Sie auf Zustimmungsbildschirm konfigurieren und folgen Sie der Anleitung auf dem Bildschirm.
5. Klicken Sie im Bereich Messwerte auf OAuth-Client erstellen.
6. Wählen Sie auf dem Bildschirm OAuth-Client-ID erstellen einen Anwendungstyp aus und geben Sie einen Namen für die Client-ID ein.
7. Geben Sie die zusätzlichen Details an, die für Ihren Anwendungstyp relevant sind. Wenn Sie beispielsweise eine Webanwendung erstellen, fügen Sie autorisierte URIs für Browser- und Serveranfragen hinzu.
8. Speichern Sie nach dem Erstellen des Clients die Client-ID und das Secret.
9. Wenn Sie Ihre MCP-Host- oder MCP-Serveranwendung für den Zugriff auf Grounding Lite konfigurieren, übergeben Sie Ihre OAuth-Client-ID und Ihr Secret. Außerdem müssen Sie den folgenden Bereich anfordern: https://www.googleapis.com/auth/maps-platform.mapstools.

Weitere Informationen finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

LLMs für den Zugriff auf den Grounding Lite MCP-Server konfigurieren

Sobald Sie ein Google Cloud-Projekt mit aktiviertem Dienst Maps Grounding Lite API und gültigen Anmeldedaten wie einem API-Schlüssel oder einer OAuth-Client-ID und einem Secret haben, können Sie LLMs für den Zugriff auf den MCP-Server konfigurieren. Folgen Sie dazu der entsprechenden Dokumentation zur MCP-Konfiguration und verwenden Sie die Grounding Lite MCP-Server-URL: https://mapstools.googleapis.com/mcp

Weitere Informationen finden Sie unter MCP in einer KI Anwendung konfigurieren.

Grounding Lite mit der Gemini CLI konfigurieren

In diesem Abschnitt wird ein Beispiel für die Konfiguration des Grounding Lite MCP Servers mit der Gemini CLI beschrieben. Weitere Informationen finden Sie unter MCP-Server mit der Gemini CLI.

1. Nachdem Sie die Gemini CLI installiert haben, können Sie den Befehl „add“ verwenden, um den Maps Grounding Lite MCP-Server zu konfigurieren:

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

   Wenn die Konfiguration erfolgreich war, wird eine Bestätigung angezeigt, dass der Server Ihren Nutzereinstellungen hinzugefügt wurde.

2. Führen Sie den Befehl /mcp list aus, um zu prüfen, ob der Server ordnungsgemäß funktioniert:

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

3. Beginnen Sie mit der CLI, Fragen zu Google Maps zu stellen. Fragen Sie beispielsweise „Recommend me some restaurants in Mountain View“. Dadurch sollte das Tool „search_places“ in Ihrem Namen aufgerufen werden.

Feedback geben

Wenn Sie Feedback zu Grounding Lite geben möchten, verwenden Sie die folgenden Formulare:

• Fehler melden
• Feature Request senden
• Feedback geben