google-maps-automation

Google Maps Automation über Rube MCP

Adressen geocodieren, Orte suchen, Routen berechnen, Entfernungsmatrizen ermitteln und Ortsdetails mit Google Maps über Rube MCP (Composio) abrufen.

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 dem Toolkit google_maps
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP einrichten: 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. Stellen Sie sicher, dass Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit dem 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 anzeigt, bevor Sie Workflows ausführen

Kern-Workflows

1. Adresse geocodieren

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 Geocodieren
  - latlng: Breitengrad/Längengrad für Reverse-Geocoding (z. B. "40.714224,-73.961452")
  - place_id: Orts-ID für Orts-Geocoding
  - 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 mithilfe einer Freitextabfrage zu finden.

Tool: GOOGLE_MAPS_TEXT_SEARCH
Parameter:
  - textQuery (erforderlich): Suchtext (z. B. "Restaurants in Berlin")
  - fieldMask: Zurückzugebende Felder (z. B. "displayName,formattedAddress,rating")
  - maxResultCount: Maximale Ergebnisse (1-20, Standard 10)

3. Routen zwischen zwei Standorten berechnen

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: BCP-47-Sprachcode
  - routeModifiers_avoidTolls / avoidHighways / avoidFerries: Routeneinstellungen

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: Einzuschließende Antwortfelder
  - units: METRIC oder IMPERIAL

5. Ortsdetails abrufen

Verwenden Sie GOOGLE_MAPS_GET_PLACE_DETAILS, um umfassende Informationen zu einem bestimmten Ort abzurufen.

Tool: GOOGLE_MAPS_GET_PLACE_DETAILS
Beschreibung: Ruft detaillierte Informationen zu einem Ort mithilfe seines Ressourcennamens
  (places/{place_id}-Format) ab. Gibt Öffnungszeiten, Kontaktdaten, 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 innerhalb eines kreisförmigen Bereichs um einen Punkt herum 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: Einzuschließende Ortstypen (z. B. ["restaurant", "cafe"])
  - excludedTypes: Auszuschließende Ortstypen
  - fieldMask: Zurückzugebende Felder
  - maxResultCount: Maximale Ergebnisse (1-20)

Häufige Muster

• Geocodierung dann Route: Verwenden Sie GOOGLE_MAPS_GEOCODING_API, um Adressen in Koordinaten umzuwandeln, dann GOOGLE_MAPS_GET_ROUTE für Routen zwischen diesen Koordinaten.
• Suche dann Detail: Verwenden Sie GOOGLE_MAPS_TEXT_SEARCH, um Orte zu finden, dann GOOGLE_MAPS_GET_PLACE_DETAILS, um umfangreichere Metadaten (Öffnungszeiten, Kontaktdaten, Bewertungen) zu erhalten.
• Autocomplete UX: Verwenden Sie GOOGLE_MAPS_AUTOCOMPLETE für Type-Ahead-Suchvorschläge, während Benutzer Adressen oder Ortsnamen eingeben.
• Reverse-Geocoding: 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 Many-to-Many-Entfernungsberechnungen, anstatt wiederholt GOOGLE_MAPS_GET_ROUTE aufzurufen.
• Karten einbetten: Verwenden Sie GOOGLE_MAPS_MAPS_EMBED_API, um einbettbare Karten-URLs für Orte, Routen oder Suchergebnisse zu generieren.

Bekannte Fallstricke

• Ergebnisstruktur der Routenmatrix: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX gibt Ergebnisse unter data.elements mit originIndex und destinationIndex sowie distanceMeters und duration zurück – nicht in einer routes[]-Struktur.
• Format der Fahrtdauer: GOOGLE_MAPS_GET_ROUTE gibt Dauern als Strings wie "937s" innerhalb von data.response_data.routes zurück. Sie müssen diese vor numerischen Vergleichen parsen.
• Orts-IDs für Verkettungen: Verwenden Sie die von GOOGLE_MAPS_TEXT_SEARCH zurückgegebenen Ortskennungen, wenn Sie GOOGLE_MAPS_GET_PLACE_DETAILS aufrufen, um umfangreichere Felder zu erhalten.
• Eingabe für Reverse-Geocoding: GOOGLE_MAPS_GEOCODE_LOCATION ist koordinatenbasiert. Stellen Sie sicher, dass Sie lat/lng (nicht einen Adressstring) übergeben, um falsche Suchvorgänge zu vermeiden.
• Einschränkungen der Routenpräferenz: 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.

Kurzübersicht

Aktion	Tool	Schlüsselparameter
Adresse geocodieren	GOOGLE_MAPS_GEOCODING_API	address oder latlng oder place_id
Reverse-Geocoding	GOOGLE_MAPS_GEOCODE_LOCATION	(vollständiges Schema über RUBE_SEARCH_TOOLS)
Textsuche	GOOGLE_MAPS_TEXT_SEARCH	textQuery, fieldMask, maxResultCount
Umgebungssuche	GOOGLE_MAPS_NEARBY_SEARCH	latitude, longitude, radius, includedTypes
Routen berechnen	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 über RUBE_SEARCH_TOOLS)
Autovervollständigung	GOOGLE_MAPS_AUTOCOMPLETE	input, includedRegionCodes, locationBias
Ortsfoto	GOOGLE_MAPS_PLACE_PHOTO	(vollständiges Schema über RUBE_SEARCH_TOOLS)
Karte einbetten	GOOGLE_MAPS_MAPS_EMBED_API	mode, plus modusspezifische Parameter

---

Bereitgestellt von Composio