Google Maps Automation via Rube MCP

Was macht Google Maps Automation via Rube MCP?

Geokodieren Sie Adressen, suchen Sie Orte, erhalten Sie Routenanweisungen, berechnen Sie Entfernungsmatrizen und rufen Sie Ortsdetails ab – mit Google Maps über Rube MCP (Composio).

Toolkit-Dokumentation: composio.dev/toolkits/google_maps

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit Toolkit google_maps
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP holen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu und es funktioniert.

1. Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit Toolkit google_maps auf
3. Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie, dass der Verbindungsstatus AKTIV ist, bevor Sie Workflows ausführen

Kern-Workflows

1. Adresse geokodieren

Verwenden Sie GOOGLE_MAPS_GEOCODING_API, um eine Straßenadresse in geografische Koordinaten (Breitengrad/Längengrad) umzuwandeln.

Tool: GOOGLE_MAPS_GEOCODING_API
Parameter:
  - address: Straßenadresse oder Plus-Code zum Geokodieren
  - latlng: Breitengrad/Längengrad für umgekehrte Geokodierung (z. B. "40.714224,-73.961452")
  - place_id: Orts-ID für die Geokodierung eines Ortes
  - language: Sprache für die Ergebnisse
  - region: Regions-Bias (ccTLD-Code)
  - bounds: Begrenzungsrahmen für Viewport-Bias
  - components: Komponentenfilter (z. B. "postal_code:94043|country:US")

2. Orte suchen

Verwenden Sie GOOGLE_MAPS_TEXT_SEARCH, um Orte mit einer Freitextabfrage zu finden.

Tool: GOOGLE_MAPS_TEXT_SEARCH
Parameter:
  - textQuery (erforderlich): Suchtext (z. B. "Restaurants in London")
  - fieldMask: Felder, die zurückgegeben werden sollen (z. B. "displayName,formattedAddress,rating")
  - maxResultCount: Maximale Ergebnisse (1-20, Standard 10)

3. Routenanweisungen zwischen zwei Orten

Verwenden Sie GOOGLE_MAPS_GET_ROUTE, um Routen mit Entfernung und Dauer zu berechnen.

Tool: GOOGLE_MAPS_GET_ROUTE
Parameter:
  - origin_address (erforderlich): Startpunkt (Adresse oder "lat,lng")
  - destination_address (erforderlich): Zielpunkt (Adresse oder "lat,lng")
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER oder TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - computeAlternativeRoutes: Alternative Routen zurückgeben (boolean)
  - units: METRIC oder IMPERIAL
  - languageCode: Sprachcode nach BCP-47
  - routeModifiers_avoidTolls / avoidHighways / avoidFerries: Routen-Einstellungen

4. Entfernungsmatrix berechnen

Verwenden Sie GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX, um Entfernungen und Dauern zwischen mehreren Start- und Zielorten zu berechnen.

Tool: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX
Parameter:
  - origins (erforderlich): Array von Startorten (Adressstrings oder lat/lng-Objekte)
  - destinations (erforderlich): Array von Zielorten
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER oder TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - fieldMask: Antwortfelder, die enthalten sein sollen
  - units: METRIC oder IMPERIAL

5. Ortsdetails abrufen

Verwenden Sie GOOGLE_MAPS_GET_PLACE_DETAILS, um umfassende Informationen über einen bestimmten Ort zu erhalten.

Tool: GOOGLE_MAPS_GET_PLACE_DETAILS
Beschreibung: Ruft detaillierte Informationen für einen Ort anhand seines Ressourcennamens
  (places/{place_id}-Format) ab. Gibt Öffnungszeiten, Kontaktinformationen, Bewertungen usw. zurück.
Hinweis: Rufen Sie RUBE_SEARCH_TOOLS auf, um das vollständige Schema für dieses Tool zu erhalten.

6. Orte in der Nähe suchen

Verwenden Sie GOOGLE_MAPS_NEARBY_SEARCH, um Orte in einem kreisförmigen Bereich um einen Punkt zu finden.

Tool: GOOGLE_MAPS_NEARBY_SEARCH
Parameter:
  - latitude (erforderlich): Breitengrad des Mittelpunkts (-90 bis 90)
  - longitude (erforderlich): Längengrad des Mittelpunkts (-180 bis 180)
  - radius (erforderlich): Suchradius in Metern (max. 50000)
  - includedTypes: Ortstypen, die eingeschlossen werden sollen (z. B. ["restaurant", "cafe"])
  - excludedTypes: Ortstypen, die ausgeschlossen werden sollen
  - fieldMask: Felder, die zurückgegeben werden sollen
  - maxResultCount: Maximale Ergebnisse (1-20)

Häufige Muster

• Geokodieren und dann Route: Verwenden Sie GOOGLE_MAPS_GEOCODING_API, um Adressen in Koordinaten umzuwandeln, dann GOOGLE_MAPS_GET_ROUTE für Routenanweisungen zwischen ihnen.
• Suchen und dann Details: Verwenden Sie GOOGLE_MAPS_TEXT_SEARCH, um Orte zu finden, dann GOOGLE_MAPS_GET_PLACE_DETAILS für umfangreichere Metadaten (Öffnungszeiten, Kontakte, Bewertungen).
• Autovervollständigungs-Benutzeroberfläche: Verwenden Sie GOOGLE_MAPS_AUTOCOMPLETE für Vorschläge während der Eingabe, während Benutzer Adressen oder Ortsnamen tippen.
• Umgekehrte Geokodierung: Verwenden Sie GOOGLE_MAPS_GEOCODE_LOCATION, um Koordinaten wieder in eine lesbare Adresse umzuwandeln.
• Stapel-Entfernungsberechnung: Verwenden Sie GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX für viele-zu-viele-Entfernungsberechnungen, anstatt wiederholt GOOGLE_MAPS_GET_ROUTE aufzurufen.
• Karten einbetten: Verwenden Sie GOOGLE_MAPS_MAPS_EMBED_API, um einbettbare Karten-URLs für Orte, Routenanweisungen oder Suchergebnisse zu generieren.

Bekannte Fallstricke

• Struktur der Routenmatrix-Ergebnisse: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX gibt Ergebnisse unter data.elements mit originIndex und destinationIndex sowie distanceMeters und duration zurück – nicht als routes[]-Struktur.
• Format der Dauer: GOOGLE_MAPS_GET_ROUTE gibt Dauern als Zeichenfolgen wie "937s" innerhalb von data.response_data.routes zurück. Sie müssen diese vor numerischen Vergleichen parsen.
• Orts-IDs für Verkettung: Verwenden Sie die von GOOGLE_MAPS_TEXT_SEARCH zurückgegebenen Ortskennungen, wenn Sie GOOGLE_MAPS_GET_PLACE_DETAILS für umfangreichere Felder aufrufen.
• Eingabe für umgekehrte Geokodierung: GOOGLE_MAPS_GEOCODE_LOCATION ist koordinatengesteuert. Stellen Sie sicher, dass Sie lat/lng (keinen Adressstring) übergeben, um fehlerhafte Suchen zu vermeiden.
• Einschränkungen der Routen-Einstellung: routingPreference kann nicht gesetzt werden, wenn travelMode WALK, BICYCLE oder TRANSIT ist – es muss für diese Modi weggelassen werden.
• Gültigkeit der Ortstypen für die Umgebungssuche: "food" ist KEIN gültiger Typ für GOOGLE_MAPS_NEARBY_SEARCH (es ist Tabelle B). Verwenden Sie stattdessen spezifische Typen wie restaurant, cafe, bakery, fast_food_restaurant.
• Embed-API verwendet nur API-Schlüssel: GOOGLE_MAPS_MAPS_EMBED_API erfordert einen API-Schlüssel und unterstützt kein OAuth2.

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Adresse geokodieren	GOOGLE_MAPS_GEOCODING_API	address oder latlng oder place_id
Umgekehrte Geokodierung	GOOGLE_MAPS_GEOCODE_LOCATION	(vollständiges Schema via RUBE_SEARCH_TOOLS)
Textsuche	GOOGLE_MAPS_TEXT_SEARCH	textQuery, fieldMask, maxResultCount
Umgebungssuche	GOOGLE_MAPS_NEARBY_SEARCH	latitude, longitude, radius, includedTypes
Routenanweisungen	GOOGLE_MAPS_GET_ROUTE	origin_address, destination_address, travelMode
Entfernungsmatrix	GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX	origins, destinations, travelMode
Ortsdetails	GOOGLE_MAPS_GET_PLACE_DETAILS	(vollständiges Schema via RUBE_SEARCH_TOOLS)
Autovervollständigung	GOOGLE_MAPS_AUTOCOMPLETE	input, includedRegionCodes, locationBias
Ortsfoto	GOOGLE_MAPS_PLACE_PHOTO	(vollständiges Schema via RUBE_SEARCH_TOOLS)
Karte einbetten	GOOGLE_MAPS_MAPS_EMBED_API	mode, plus modus-spezifische Parameter

---

Powered by Composio