Automação do Google Maps via Rube MCP

Geocodifique endereços, pesquise locais, obtenha direções, calcule matrizes de distância e recupere detalhes de locais usando o Google Maps via Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/google_maps

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit google_maps
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit google_maps
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Geocodificar um Endereço

Use GOOGLE_MAPS_GEOCODING_API para converter um endereço de rua em coordenadas geográficas (latitude/longitude).

Tool: GOOGLE_MAPS_GEOCODING_API
Parameters:
  - address: Street address or plus code to geocode
  - latlng: Lat/lng for reverse geocoding (e.g., "40.714224,-73.961452")
  - place_id: Place ID for place geocoding
  - language: Language for results
  - region: Region bias (ccTLD code)
  - bounds: Bounding box for viewport bias
  - components: Component filter (e.g., "postal_code:94043|country:US")

2. Pesquisar por Locais

Use GOOGLE_MAPS_TEXT_SEARCH para encontrar locais usando uma consulta de texto livre.

Tool: GOOGLE_MAPS_TEXT_SEARCH
Parameters:
  - textQuery (required): Search text (e.g., "restaurants in London")
  - fieldMask: Fields to return (e.g., "displayName,formattedAddress,rating")
  - maxResultCount: Max results (1-20, default 10)

3. Obter Direções Entre Dois Locais

Use GOOGLE_MAPS_GET_ROUTE para calcular rotas com distância e duração.

Tool: GOOGLE_MAPS_GET_ROUTE
Parameters:
  - origin_address (required): Starting point (address or "lat,lng")
  - destination_address (required): End point (address or "lat,lng")
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER, or TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - computeAlternativeRoutes: Return alternative routes (boolean)
  - units: METRIC or IMPERIAL
  - languageCode: BCP-47 language code
  - routeModifiers_avoidTolls / avoidHighways / avoidFerries: Route preferences

4. Calcular Matriz de Distância

Use GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX para calcular distâncias e durações entre várias origens e destinos.

Tool: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX
Parameters:
  - origins (required): Array of origin locations (address strings or lat/lng objects)
  - destinations (required): Array of destination locations
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER, or TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - fieldMask: Response fields to include
  - units: METRIC or IMPERIAL

5. Obter Detalhes do Local

Use GOOGLE_MAPS_GET_PLACE_DETAILS para recuperar informações abrangentes sobre um local específico.

Tool: GOOGLE_MAPS_GET_PLACE_DETAILS
Description: Retrieves comprehensive details for a place using its resource
  name (places/{place_id} format). Returns hours, contacts, reviews, etc.
Note: Call RUBE_SEARCH_TOOLS to get the full schema for this tool.

6. Pesquisar Locais Próximos

Use GOOGLE_MAPS_NEARBY_SEARCH para encontrar locais dentro de uma área circular ao redor de um ponto.

Tool: GOOGLE_MAPS_NEARBY_SEARCH
Parameters:
  - latitude (required): Center latitude (-90 to 90)
  - longitude (required): Center longitude (-180 to 180)
  - radius (required): Search radius in meters (max 50000)
  - includedTypes: Place types to include (e.g., ["restaurant", "cafe"])
  - excludedTypes: Place types to exclude
  - fieldMask: Fields to return
  - maxResultCount: Max results (1-20)

Padrões Comuns

• Geocodificar e depois traçar rota: Use GOOGLE_MAPS_GEOCODING_API para converter endereços em coordenadas, depois GOOGLE_MAPS_GET_ROUTE para obter direções entre eles.
• Pesquisar e depois obter detalhes: Use GOOGLE_MAPS_TEXT_SEARCH para encontrar locais, depois GOOGLE_MAPS_GET_PLACE_DETAILS para metadados mais ricos (horários, contatos, avaliações).
• Experiência do usuário de autocompletar: Use GOOGLE_MAPS_AUTOCOMPLETE para sugestões de pesquisa preditiva enquanto os usuários digitam endereços ou nomes de locais.

…