automação-google-maps

Automação do Google Maps via Rube MCP

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

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

Pré-requisitos

• 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 atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu 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 que o status da conexão mostra ATIVA antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Geocodificar um Endereço

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

Ferramenta: GOOGLE_MAPS_GEOCODING_API
Parâmetros:
  - address: Endereço ou plus code para geocodificar
  - latlng: Lat/lng para geocodificação reversa (ex.: "40.714224,-73.961452")
  - place_id: ID do lugar para geocodificação por lugar
  - language: Idioma dos resultados
  - region: Viés regional (código ccTLD)
  - bounds: Caixa delimitadora para viés de viewport
  - components: Filtro de componentes (ex.: "postal_code:94043|country:US")

2. Pesquisar Lugares

Use GOOGLE_MAPS_TEXT_SEARCH para encontrar lugares usando uma consulta em texto livre.

Ferramenta: GOOGLE_MAPS_TEXT_SEARCH
Parâmetros:
  - textQuery (obrigatório): Texto de pesquisa (ex.: "restaurantes em São Paulo")
  - fieldMask: Campos a retornar (ex.: "displayName,formattedAddress,rating")
  - maxResultCount: Máximo de resultados (1-20, padrão 10)

3. Obter Direções Entre Dois Locais

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

Ferramenta: GOOGLE_MAPS_GET_ROUTE
Parâmetros:
  - origin_address (obrigatório): Ponto de partida (endereço ou "lat,lng")
  - destination_address (obrigatório): Ponto de chegada (endereço ou "lat,lng")
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER ou TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - computeAlternativeRoutes: Retornar rotas alternativas (booleano)
  - units: METRIC ou IMPERIAL
  - languageCode: Código de idioma BCP-47
  - routeModifiers_avoidTolls / avoidHighways / avoidFerries: Preferências de rota

4. Calcular Matriz de Distância

Use GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX para calcular distâncias e durações entre múltiplas origens e destinos.

Ferramenta: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX
Parâmetros:
  - origins (obrigatório): Array de locais de origem (strings de endereço ou objetos lat/lng)
  - destinations (obrigatório): Array de locais de destino
  - travelMode: DRIVE, BICYCLE, WALK, TWO_WHEELER ou TRANSIT
  - routingPreference: TRAFFIC_UNAWARE, TRAFFIC_AWARE, TRAFFIC_AWARE_OPTIMAL
  - fieldMask: Campos de resposta a incluir
  - units: METRIC ou IMPERIAL

5. Obter Detalhes de um Lugar

Use GOOGLE_MAPS_GET_PLACE_DETAILS para recuperar informações completas sobre um lugar específico.

Ferramenta: GOOGLE_MAPS_GET_PLACE_DETAILS
Descrição: Recupera detalhes completos de um lugar usando seu nome de recurso
  (formato places/{place_id}). Retorna horários, contatos, avaliações, etc.
Nota: Chame RUBE_SEARCH_TOOLS para obter o esquema completo desta ferramenta.

6. Pesquisar Lugares Próximos

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

Ferramenta: GOOGLE_MAPS_NEARBY_SEARCH
Parâmetros:
  - latitude (obrigatório): Latitude do centro (-90 a 90)
  - longitude (obrigatório): Longitude do centro (-180 a 180)
  - radius (obrigatório): Raio de pesquisa em metros (máx. 50000)
  - includedTypes: Tipos de lugar a incluir (ex.: ["restaurant", "cafe"])
  - excludedTypes: Tipos de lugar a excluir
  - fieldMask: Campos a retornar
  - maxResultCount: Máximo de resultados (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 lugares, depois GOOGLE_MAPS_GET_PLACE_DETAILS para metadados mais ricos (horários, contatos, avaliações).
• Autocomplete UX: Use GOOGLE_MAPS_AUTOCOMPLETE para sugestões de pesquisa conforme o usuário digita endereços ou nomes de lugares.
• Geocodificação reversa: Use GOOGLE_MAPS_GEOCODE_LOCATION para converter coordenadas de volta para um endereço legível.
• Cálculo em lote de distâncias: Use GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX para cálculos de distância muitos-para-muitos em vez de chamar GOOGLE_MAPS_GET_ROUTE repetidamente.
• Incorporar mapas: Use GOOGLE_MAPS_MAPS_EMBED_API para gerar URLs de mapas incorporáveis para lugares, direções ou resultados de pesquisa.

Armadilhas Conhecidas

• Estrutura de resultados da matriz de rotas: GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX retorna resultados em data.elements com originIndex e destinationIndex além de distanceMeters e duration — não uma estrutura routes[].
• Formato da duração: GOOGLE_MAPS_GET_ROUTE retorna durações como strings do tipo "937s" dentro de data.response_data.routes. Você deve analisar essas strings antes de fazer comparações numéricas.
• IDs de lugares para encadeamento: Use os identificadores de lugar retornados por GOOGLE_MAPS_TEXT_SEARCH ao chamar GOOGLE_MAPS_GET_PLACE_DETAILS para campos mais ricos.
• Entrada para geocodificação reversa: GOOGLE_MAPS_GEOCODE_LOCATION é orientada por coordenadas. Certifique-se de passar lat/lng (não uma string de endereço) para evitar correspondências incorretas.
• Restrições de preferência de roteamento: routingPreference não pode ser definido quando travelMode é WALK, BICYCLE ou TRANSIT — deve ser omitido para esses modos.
• Validade dos tipos na pesquisa por proximidade: "food" NÃO é um tipo válido para GOOGLE_MAPS_NEARBY_SEARCH (é da Tabela B). Use tipos específicos como restaurant, cafe, bakery, fast_food_restaurant.
• API de Embed usa apenas chaves de API: GOOGLE_MAPS_MAPS_EMBED_API requer uma chave de API e não suporta OAuth2.

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Geocodificar endereço	GOOGLE_MAPS_GEOCODING_API	address ou latlng ou place_id
Geocodificação reversa	GOOGLE_MAPS_GEOCODE_LOCATION	(ver esquema completo via RUBE_SEARCH_TOOLS)
Pesquisa textual	GOOGLE_MAPS_TEXT_SEARCH	textQuery, fieldMask, maxResultCount
Pesquisa por proximidade	GOOGLE_MAPS_NEARBY_SEARCH	latitude, longitude, radius, includedTypes
Obter direções	GOOGLE_MAPS_GET_ROUTE	origin_address, destination_address, travelMode
Matriz de distâncias	GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX	origins, destinations, travelMode
Detalhes do lugar	GOOGLE_MAPS_GET_PLACE_DETAILS	(ver esquema completo via RUBE_SEARCH_TOOLS)
Autocomplete	GOOGLE_MAPS_AUTOCOMPLETE	input, includedRegionCodes, locationBias
Foto do lugar	GOOGLE_MAPS_PLACE_PHOTO	(ver esquema completo via RUBE_SEARCH_TOOLS)
Incorporar mapa	GOOGLE_MAPS_MAPS_EMBED_API	mode, mais parâmetros específicos do modo

---

Desenvolvido por Composio