Mit der Pro-SKU können Sie mehr Funktionen der Agent-Tools für Maps Experience nutzen. Wenden Sie sich an den Vertrieb, um Zugriff zu erhalten.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Tools für den Maps Experience-Agenten

Maps Experience-Agent-Tools (früher Maps Grounding Lite) ist ein Google Maps Platform-Dienst mit Unterstützung für das Model Context Protocol (MCP), mit dem Sie Ihre KI-Anwendungen mit vertrauenswürdigen Geodaten aus Google Maps fundieren können. Der MCP-Server stellt Tools bereit, mit denen LLMs auf Orts-, Wetter- und Routendaten zugreifen können. Andere Tools lösen Ortsnamen und Google Maps-URLs in Orts-IDs auf. Sie können die Agent-Tools für Maps Experience ausprobieren, indem Sie sie in einem beliebigen Tool aktivieren, das MCP-Server unterstützt.

Die Agent-Tools für Maps Experience sind ein Produkt mit zwei SKUs: Essentials und Pro. Jede Anfrage wird im Rahmen von Essentials abgerechnet, sofern keine Pro-Option verwendet wird. Mit den Pro-Optionen erhalten Sie erweiterte Ortsdetails, mehr Orte pro Suche, mehr Zwischenstopps pro Route und Routenplanung mit Echtzeit-Verkehrsinformationen. Während der eingeschränkten GA sind Pro-Optionen nur für Projekte auf der Pro-Zulassungsliste verfügbar. Beide SKUs verwenden denselben MCP-Server, dieselben Tools und dieselben Anmeldedaten. Weitere Informationen finden Sie unter Essentials und Pro.

Tools

Mit den Tools des Maps Experience-Agenten können LLMs auf die folgenden Google Maps-Funktionen zugreifen:

Nach Orten suchen: Sie können Informationen zu Orten anfordern und KI-generierte Zusammenfassungen erhalten. Die Antwort enthält außerdem Orts-IDs, Koordinaten und Google Maps-URLs für jeden Ort in der Zusammenfassung. Sie können die Orts-IDs und Koordinaten mit anderen Google Maps Platform APIs verwenden, um Orte auf einer Karte anzuzeigen. Mit Pro können Sie erweiterte Place Details wie Informationen aus Rezensionen und bis zu 10 Orte pro Anfrage anfordern.
Wetter abrufen: Informationen zum Wetter anfordern und aktuelle Bedingungen, stündliche Vorhersagen und tägliche Vorhersagen zurückgeben.
Routen berechnen: Sie können eine Route zwischen einem Start- und einem Zielort anfordern, optional mit Zwischenstopps, und die Entfernung und Dauer der Route zurückgeben lassen. Mit Pro können Routen die aktuelle Verkehrslage berücksichtigen und mehr Zwischenstopps enthalten.

Hinweis: Die Agent-Tools für Maps Experience bieten keine detaillierten Wegbeschreibungen oder Navigationsinformationen. Bei Routen, die ohne Pro-Optionen berechnet werden, wird die aktuelle Verkehrslage nicht berücksichtigt.
Namen auflösen und Maps-URLs auflösen: Ortsnamen, Adressen und Google Maps-URLs in Orts-IDs auflösen. Weitere Informationen finden Sie unter Resolution API.

Nachdem Sie den MCP-Server aktiviert haben, können LLMs seine Tools aufrufen, um Fundierungsinformationen für diese Datentypen abzurufen. Das LLM kann diese Informationen als Kontext verwenden. Die endgültige Antwort enthält jedoch möglicherweise nicht die genauen Informationen, die der MCP-Server zurückgegeben hat. Sie sollten die Richtigkeit der generierten Antwort überprüfen.

Essentials und Pro

Essentials und Pro sind zwei SKUs desselben Produkts, keine separaten Produkte oder Tarife. Eine Anfrage wird unter Pro abgerechnet, wenn eine Pro-Option verwendet wird. Alle anderen Anfragen werden unter Essentials abgerechnet. Pro-Optionen sind gewöhnliche Felder in der Toolanfrage, sodass ein LLM sie in Ihrem Namen verwenden kann. Ein KI-Agent kann auch beide SKUs in derselben Unterhaltung verwenden. Ein Agent könnte beispielsweise Essentials verwenden, um Cafés in der Nähe einer Sehenswürdigkeit zu finden. Anschließend könnte Pro verwendet werden, um eine weiterführende Frage zu den Signature-Drinks und Sitzgelegenheiten zu beantworten. Es gibt keinen separaten MCP-Server, Endpunkt oder Anmeldedaten für Pro.

Essentials, Pro und Fundierung mit Google Maps vergleichen

Fundierung mit Google Maps ist ein separates Produkt. Sie ist in Gemini-Modelle in der Gemini API, in Google AI Studio und in der Gemini Enterprise Agent Platform integriert. Das Modell entscheidet, wann Google Maps abgefragt werden soll, und gibt fundierte Antworten mit Quellenangaben zurück. Wählen Sie die Fundierung mit Google Maps, wenn Sie auf Gemini aufbauen und möchten, dass das Modell die Fundierung übernimmt. Wählen Sie Maps Experience-Agent-Tools für andere Modelle oder Agent-Frameworks oder für die direkte Steuerung jedes Toolaufrufs aus.

	Tools für den Maps Experience-Agenten		Fundierung mit Google Maps
	Essentials-SKU (früher Maps Grounding Lite)	Pro SKU	Fundierung mit Google Maps
Abrechnung von Anfragen	Jede Toolanfrage, bei der keine Pro-Option verwendet wird	Jede Toolanfrage, die eine Pro-Option verwendet: `include_extended_details`, ein `page_size` über 5, `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` oder mehr als 10 Zwischenwegpunkte	Jede Google Maps-Abfrage oder jeder fundierte Prompt, je nach Plattform und Modell
Modelle und Plattformen	Jedes Modell- oder Agenten-Framework, das MCP unterstützt. Ein MCP-Server, ein Satz von Tools und dieselben Anmeldedaten für beide SKUs		Gemini-Modelle in der Gemini API, in Google AI Studio und in der Gemini Enterprise Agent Platform
Was die Tools zurückgeben	Wichtige Fakten: Ortsdetails für bis zu 5 Orte pro Suche, Routenentfernung und ‑dauer ohne Live-Verkehrsdaten sowie aktuelles Wetter und Vorhersagen	Alles, was in Essentials enthalten ist, plus erweiterte Ortsdetails (z. B. Informationen aus Rezensionen), bis zu 10 Orte pro Suche, Routen mit Live-Verkehrsdaten und bis zu 25 Zwischenwegpunkte	Ortsdetails und Informationen aus Rezensionen sowie Routeninformationen mit Echtzeit-Verkehrslage
Beispielanfragen	Faktische und logistische Fragen: Geschäfte oder Unternehmen, Öffnungszeiten, Adressen und Schätzungen zu Entfernung oder Fahrtzeit finden	Subjektive oder allgemeine Fragen: Atmosphäre, Spezialitäten, Tipps für Besucher, Vergleiche von 6 bis 10 Orten und Fahrtzeiten bei aktueller Verkehrslage	Konversationelle Suche, Reiseplanung und lokale Entdeckungen in Gemini
Places UI Kit-Visualisierungen	Ohne zusätzliche Kosten im Token für die agentische Datenvisualisierung (Vorabversion) enthalten		Separat abgerechnet
Kostenlose Nutzung pro Monat	10.000 Anfragen	5.000 Anfragen	Abhängig von der Plattform und dem Modell. In der Gemini API sind beispielsweise für Gemini 3 und neuere Modelle 5.000 kostenlose Suchanfragen pro Monat enthalten. Danach kosten Suchanfragen 14 $ pro 1.000 Anfragen.
Pay as you go-Preis	7,00 $ pro 1.000 Anfragen, mit Mengenrabatten	14,00 $ pro 1.000 Anfragen. Vertriebsteam kontaktieren, um Informationen zu Mengenrabatten zu erhalten
Jetzt abonnieren und sparen	In den Essentials- und Pro-Abos enthalten	Nicht enthalten	Nicht verfügbar
Jetzt starten	Eine Einrichtung für beide SKUs: siehe LLMs für die Verwendung des MCP-Servers konfigurieren. Während der eingeschränkten GA-Phase ist für Pro-Optionen auch ein Projekt auf der Pro-Zulassungsliste erforderlich.		Gemini API oder Agent Platform

Diese Optionen funktionieren mit beiden SKUs gleich: Mobilitätsformen, Abfahrts- und Ankunftszeiten, alternative Routen, Routenpolylinien, Wetterabfragen und die Resolution API. Sie ändern nicht, unter welcher SKU eine Anfrage abgerechnet wird.

Was wird unter der Pro-SKU abgerechnet?

Tool	Funktion	Essentials	Pro
Orte suchen	Orte pro Anfrage	Bis zu 5	6 bis 10 (`page_size` von 6 bis 10)
Orte suchen	Erweiterte Place Details in Suchzusammenfassungen (Insights aus Rezensionen, Highlights auf der Speisekarte, Atmosphäre, Besucheraufkommen, Tipps für Besucher sowie Entfernung oder Reisedauer bei Suchanfragen nach Orten in der Nähe)	Nicht verfügbar	Verfügbar mit `include_extended_details`
Routen berechnen	Routingeinstellung	Aktuelle Verkehrslage wird nicht berücksichtigt	Berücksichtigt aktuelle Verkehrsdaten oder Echtzeitdaten für öffentliche Verkehrsmittel mit `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`
Routen berechnen	Wegpunkte entlang der Route pro Route	Bis zu 10	11 bis 25 (mehr als 10 `intermediate_waypoints`)
Lookup Weather API und Resolution API	Keine Pro-Optionen. Alle Anfragen werden unter der Essentials-SKU abgerechnet.

Informationen zu den Anfrageoptionen, mit denen die einzelnen Funktionen aktiviert werden, finden Sie unter Orte suchen und Routen berechnen.

Pro-Optionen während der eingeschränkten GA

Während der eingeschränkten GA sind Pro-Optionen nur für Google Cloud-Projekte auf der Pro-Zulassungsliste verfügbar. Wenden Sie sich an den Vertrieb, um Zugriff anzufordern. Sobald ein Projekt auf der Zulassungsliste steht, können alle API-Schlüssel und OAuth-Clients darin Pro-Optionen verwenden.

Wenn Ihr Projekt noch nicht auf der Zulassungsliste steht, werden Anfragen, die Pro-Optionen verwenden, so verarbeitet:

Orte suchen: include_extended_details wird ignoriert und die Antwort enthält maximal 5 Orte, auch wenn Sie page_size höher festlegen. Die Anfrage wird unter der Essentials-SKU abgerechnet.
Routen berechnen: ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird als ROUTING_PREFERENCE_TRAFFIC_UNAWARE behandelt und die Anfrage wird über die Essentials-SKU abgerechnet. Bei einer Anfrage mit mehr als 10 Zwischenwegpunkten wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn Sie prüfen möchten, ob Ihr Projekt auf der Zulassungsliste steht, senden Sie eine search_places-Anfrage, wobei page_size auf 10 gesetzt ist. Verwenden Sie eine allgemeine Abfrage wie restaurants in Chicago. Ein Projekt auf der Zulassungsliste kann mehr als 5 Orte zurückgeben, die unter der Pro-SKU abgerechnet werden. Bei anderen Projekten werden maximal 5 Orte zurückgegeben.

Pro-Nutzung steuern

Pro-Optionen sind standardmäßig deaktiviert. Ein LLM legt sie fest, wenn die Anfrage des Nutzers dies erfordert und das Toolschema oder Ihre Anweisungen dies zulassen. Das Toolschema beschreibt page_size-Werte bis zu 5 und maximal 10 Zwischenwegpunkte. Die Modelle verwenden die höheren Pro-Limits daher nur, wenn Ihre Anweisungen dies erfordern. So verwalten Sie die Kosten:

Teilen Sie dem Modell mit, wann Pro-Optionen angemessen sind. Beispiel: „Setze include_extended_details nur, wenn der Nutzer nach Rezensionen, Speisekarten oder der Atmosphäre fragt.“ Oder: „Verwende ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL nur, wenn der Nutzer nach einer aktuellen Reisedauer fragt.“
Wenn Sie einen KI-Agenten in der Essentials-SKU behalten möchten, weisen Sie das Modell an, niemals eine Pro-Option zu verwenden. Die Pro-Optionen sind include_extended_details, page_size über 5, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL und mehr als 10 Zwischenwegpunkte. Wenn Ihr MCP-Client Toolargumente einschränken kann, können Sie diese Werte auch in der Toolkonfiguration blockieren.
Sie können Ihre Nutzung in den Abrechnungsberichten im Blick behalten und Budgetbenachrichtigungen einrichten.

Resolution API

Die Resolution API ist über die Agent-Tools für Maps Experience verfügbar. Sie löst freien Text und URLs zu Standorten in strukturierte Google Maps-Ortskennungen auf. Die Resolution API ist als REST-Methoden und als Tools auf dem MCP-Server verfügbar:

Namen auflösen (REST, MCP): Eine Gruppe von Standortnamen oder Adressen in bestimmte Ortsentitäten auf Google Maps auflösen. Das ist nützlich, um unstrukturierte Nutzeranfragen in stabilen Orts-IDs zu fundieren.
Maps-URLs auflösen (REST, MCP): Eine Gruppe von Google Maps-URLs in bestimmte Ortselemente auflösen. Zu den unterstützten Formaten gehören Standard-Orts-URLs und gekürzte URLs.

Sie können die zurückgegebenen Orts-IDs mit anderen Google Maps Platform APIs verwenden. Jede Antwort enthält außerdem einen Link, über den die aufgelösten Orte als Liste in Google Maps gespeichert werden können.

Weitere Informationen finden Sie unter Maps Tools Resolution API.

Beispiel-App ausprobieren (wird in einem neuen Tab geöffnet)

Abrechnung und Kontingente

Abrechnung

Beim „Pay as you go“-Preismodell der Google Maps Platform wird die Nutzung von Agent-Tools für Maps Experience für jede Anfrage berechnet. Jede Anfrage stellt ein Abrechnungsereignis dar. Die Nutzung wird jeweils pro Produkt-SKU erfasst. Ihre Rechnung enthält neben den Gesamtkosten eine Position für jede SKU. Weitere Informationen finden Sie in der Übersicht über die Berichterstellung.

Jede Anfrage vom Typ „Search places“, „Compute routes“ oder „Lookup weather“ wird unter genau einer SKU abgerechnet, Essentials oder Pro. Eine Anfrage, bei der eine Pro-Option verwendet wird, wird unter der Pro-SKU abgerechnet. Die Abrechnung erfolgt nie unter beiden SKUs und die Anzahl der Pro-Optionen hat keinen Einfluss auf die Gebühr. Die folgenden Optionen bestimmen die SKU:

Tool	Essentials	Pro
`search_places`	Anfragen ohne Pro-Option: `page_size` mit einem Wert von maximal 5 und `include_extended_details` nicht festgelegt oder `false`	`include_extended_details` auf `true` festgelegt oder `page_size` von 6 auf 10
`compute_routes`	Anfragen ohne Pro-Option: `routing_preference` nicht festgelegt oder `ROUTING_PREFERENCE_TRAFFIC_UNAWARE` und maximal 10 Zwischenwegpunkte, mit beliebigem Mobilitätsmodus	`routing_preference` auf `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` festgelegt oder 11 bis 25 Zwischenwegpunkte
`lookup_weather`	Für alle Anfragen gilt:	–

Informationen zu den Essentials-Preisen finden Sie in den Details zur Essentials-SKU. Pro-Anfragen werden nach den ersten 5.000 Anfragen pro Monat mit 14,00 $ pro 1.000 Anfragen abgerechnet. Kontaktieren Sie den Vertrieb, um Informationen zu Mengenrabatten zu erhalten.

Während der eingeschränkten GA-Phase werden Pro-Optionen nur für Projekte auf der Pro-Zulassungsliste wirksam. Weitere Informationen finden Sie unter Pro-Optionen während der eingeschränkten GA.

Weitere Informationen zu den Preisen finden Sie in der Hauptpreistabelle und in der Preistabelle für Indien.

Anfragen an die Resolution API (ResolveNames und ResolveMapsUrls) werden kostenlos über die SKU Places API Text Search Essentials (IDs Only) abgerechnet.

Die Nutzung der Essentials-SKU ist auch in den Essentials- und Pro-Paketen Abo abschließen und sparen enthalten. Die Pro-SKU ist nicht in „Abo mit Sparvorteil“-Paketen enthalten.

Kontingente

Für die Tools und APIs, die von den Agent-Tools für Maps Experience bereitgestellt werden, gelten die folgenden Kontingente:

Orte suchen: 300 Anfragen pro Minute und Projekt.
Wetter abfragen: 300 Abfragen pro Minute und Projekt.
Routen berechnen: 300 Anfragen pro Minute und Projekt.
Namen auflösen: 600 Abfragen pro Minute und Projekt.
Maps-URLs auflösen: 600 Abfragen pro Minute und Projekt.

Kontingente werden pro Tool gezählt und von den Essentials- und Pro-SKUs gemeinsam genutzt. Eine Pro-Anfrage verbraucht dasselbe Kontingent wie eine Essentials-Anfrage an dasselbe Tool.

Jede Resolution API-Anfrage zählt als eine Abfrage, unabhängig davon, wie viele Elemente sie enthält.

Richtlinien und Nutzungsbedingungen

Die Agent-Tools für Maps Experience unterliegen den Nutzungsbedingungen für die Google Maps Platform, einschließlich der dienstspezifischen Nutzungsbedingungen. In diesem Abschnitt werden zusätzliche Nutzungsanforderungen für Maps Experience-Agent-Tools beschrieben, einschließlich kompatibler LLMs und Quellenangaben. Die Anforderungen gelten für alle Ergebnisse, unabhängig davon, über welche SKU eine Anfrage abgerechnet wird.

Anforderungen an kompatible LLMs

Sie dürfen die Agent-Tools für Maps Experience nur mit einem LLM verwenden, das den Nutzungsbedingungen der Google Maps Platform entspricht.

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

Anforderungen an die Quellenangabe für Google Maps-Quellen

Jede Toolantwort von Maps Experience-Agent-Tools enthält Quellen. Wenn Sie Ergebnisse aus Agent-Tools für Maps Experience präsentieren, müssen Sie die zugehörigen Google Maps-Quellen angeben und die folgenden Anforderungen erfüllen:

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

Quellen für das Tool „Orte suchen“

Das Feld places des search_places-Tools 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 generieren, die die folgenden Anforderungen erfüllt:

Geben Sie jede Quelle gemäß den Richtlinien für die Quellenangabe von Text für Agent-Tools für Maps-Anwendungen als Google Maps an.
Verknüpfen Sie die Quelle mit der places.googleMapsLinks.placeUrl aus der Antwort.

Diese Anforderungen gelten auch für Zusammenfassungen, die erweiterte Ortsdetails aus Pro enthalten, z. B. Informationen aus Rezensionen. In der summary wird jeder Ort mit einem nullbasierten Index angegeben, z. B. [0], der einem Eintrag in places zugeordnet ist. Jeder Ort enthält auch googleMapsLinks.reviewsUrl, das mit den Rezensionen des Orts auf Google Maps verknüpft ist. Nutzer können ihm folgen, um die Rezensionen hinter einer Statistik zu sehen.

Sprachgesteuerte Benutzeroberflächen

Wenn Ihre App die Ergebnisse der Maps Experience-Agent-Tools per Sprachausgabe ausgibt, müssen Sie auch die Anforderungen für Sprachschnittstellen erfüllen. Zusammenfassung:

Quellenangabe: Zeigen Sie die Google Maps-Quellen in einer Companion-Benutzeroberfläche an, die eine wortgetreue Aufzeichnung der Sprachunterhaltung enthält.
Aktive Offenlegung: Informieren Sie Nutzer zum Zeitpunkt der Interaktion darüber, dass KI-generierte Inhalte Informationen aus Google Maps enthalten können. Teilen Sie ihnen auch mit, dass detaillierte Quellen in der Companion-Benutzeroberfläche verfügbar sind. Das geht über das Display oder per Sprachbefehl.
Dauerhafte Offenlegung: Behalten Sie eine dauerhafte Erklärung bei, z. B. in einem Menü für Spracheinstellungen, dass KI-generierte Inhalte Google Maps-Inhalte enthalten können.
Nutzeranfragen: Beantworte die Fragen der Nutzer zur Quelle des Inhalts genau und verweise sie auf die Companion-UI, um weitere Informationen zu erhalten.

LLMs für die Verwendung des MCP-Servers konfigurieren

Wenn Sie die Agent-Tools für Maps Experience verwenden möchten, benötigen Sie ein Google Cloud-Projekt, in dem der API-Dienst Agent-Tools für Maps Experience aktiviert ist. Außerdem benötigen Sie einen API-Schlüssel oder eine OAuth-Client-ID. Anschließend können Sie LLMs so konfigurieren, dass sie auf den MCP-Server zugreifen. Der MCP-Server verwendet den streamfähigen HTTP-Transport.

Maps Experience-Agent-Tools in Ihrem Google Cloud-Projekt aktivieren

So aktivieren Sie die API in Ihrem Projekt:

Wählen Sie in der Google Cloud Console das Projekt aus, das Sie für die Agent-Tools für Maps Experience verwenden möchten.
Aktivieren Sie die Abrechnung für das Projekt in der Google Cloud Console.
Aktivieren Sie die Tools für Maps Experience-Agenten in der API-Bibliothek der Google Cloud Console.

Mit einem API-Schlüssel authentifizieren

Sie können einen vorhandenen API-Schlüssel mit den Agent-Tools für Maps Experience verwenden oder einen neuen erstellen. Aktivieren Sie in beiden Fällen den API-Dienst Maps Experience Agent Tools sowohl für das Google Cloud-Projekt als auch für den Schlüssel.

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

Erstellen oder konfigurieren Sie einen API-Schlüssel, indem Sie die Schritte unter Erste Schritte mit der Google Maps Platform ausführen.
Ü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.

Mit OAuth authentifizieren

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

So authentifizieren Sie sich mit OAuth:

Wählen Sie in der Google Cloud Console das Projekt aus, das Sie für die Agent-Tools für Maps Experience verwenden möchten.
Wählen Sie im Menü APIs und Dienste die Option Anmeldedaten aus.
Wählen Sie im Menü oben Anmeldedaten erstellen > OAuth-Client-ID aus.
Wenn für das Projekt kein Zustimmungsbildschirm konfiguriert ist, klicken Sie auf Zustimmungsbildschirm konfigurieren und folgen Sie der Anleitung auf dem Bildschirm.
Klicken Sie im Bereich Messwerte auf OAuth-Client erstellen.
Wählen Sie auf dem Bildschirm OAuth-Client-ID erstellen einen Anwendungstyp aus und geben Sie einen Namen für die Client-ID ein.
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.
Nachdem der Client erstellt wurde, speichern Sie die Client-ID und den Clientschlüssel.
Übergeben Sie beim Konfigurieren Ihrer MCP-Host- oder MCP-Serveranwendung Ihre OAuth-Client-ID und Ihr OAuth-Secret. Außerdem müssen Sie den folgenden Bereich anfordern: https://www.googleapis.com/auth/maps-platform.mapstools.

Weitere Informationen finden Sie unter OAuth 2.0 für den Zugriff auf Google APIs verwenden.

LLMs für den Zugriff auf den MCP-Server für die Agent-Tools von Maps Experience konfigurieren

Nachdem Sie den Dienst Maps Experience Agent Tools aktiviert und Anmeldedaten erstellt haben, können Sie LLMs für den Zugriff auf den MCP-Server konfigurieren. Folgen Sie der MCP-Konfigurationsdokumentation Ihres LLM und verwenden Sie die MCP-Server-URL: https://mapstools.googleapis.com/mcp

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

Maps Experience-Agententools mit der Gemini CLI konfigurieren

In diesem Abschnitt finden Sie ein Beispiel für die Konfiguration des MCP-Servers für die Agent-Tools von Maps Experience mit der Gemini CLI. Weitere Informationen finden Sie unter MCP-Server mit der Gemini CLI.

Führen Sie nach der Installation der Gemini CLI gemini mcp add aus, um den MCP-Server zu konfigurieren:
```
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcp
```
Wenn die Konfiguration erfolgreich war, sollten Sie eine Bestätigung sehen, dass der Server Ihren Nutzereinstellungen hinzugefügt wurde.

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

> /mcp list

Configured MCP servers:

maps-experience-agent-tools-mcp - Ready (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places

Stellen Sie über die Befehlszeile Fragen zu Google Maps. Versuchen Sie es beispielsweise mit „Empfiehl mir ein paar Restaurants in Mountain View“. Dadurch sollte das Tool „search_places“ in Ihrem Namen aufgerufen werden.

Maps Experience-Agent-Tools mit dem Agent Development Kit (ADK) konfigurieren

In diesem Abschnitt wird gezeigt, wie Sie den MCP-Server mit dem Agent Development Kit (ADK) in Python, Java oder TypeScript konfigurieren.

Python

Eine vollständige Implementierung dieses Beispiels finden Sie auf GitHub im adk-samples-Repository.

Schritt 1: KI-Agenten mit `McpToolset` für Maps Experience-Agententools definieren

Ändern Sie die Datei agent.py. Ersetzen Sie YOUR_GOOGLE_MAPS_API_KEY durch Ihren tatsächlichen API-Schlüssel.

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)

Schritt 2: Prüfen, ob `init.py` vorhanden ist

Achten Sie darauf, dass sich im selben Verzeichnis wie Ihre agent.py eine __init__.py befindet:

from . import agent

Schritt 3: `adk web` ausführen und interagieren

Umgebungsvariable festlegen:
Legen Sie Ihren Google Maps API-Schlüssel als Umgebungsvariable in Ihrem Terminal fest:
```
export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
        
```
adk web ausführen:
Führen Sie den folgenden Befehl aus, um die ADK-Weboberfläche zu starten:
```
adk web
        
```
In der Benutzeroberfläche interagieren:
- Wählen Sie das travel_planner_agent aus.
- Probieren Sie Prompts wie die folgenden aus:
  - „Ich bin morgen in San Francisco. Wie ist das Wetter?“
  - „Finde Cafés in der Nähe des Golden Gate Parks.“
  - „Route vom Googleplex zum SFO“

Java

Definieren Sie einen Agenten, der den McpToolset in Java initialisiert. Ersetzen Sie YOUR_GOOGLE_MAPS_API_KEY_HERE durch den tatsächlichen API-Schlüssel, den Sie erhalten haben, wenn Sie keine Umgebungsvariable verwenden.

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

TypeScript

Definieren Sie einen Agenten, der den MCPToolset in TypeScript initialisiert:

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

Feedback geben

Wenn Sie Feedback zu den Agent-Tools für Maps Experience geben möchten, verwenden Sie die folgenden Formulare: