Google Maps
Geocodificar endereços, buscar lugares, calcular rotas e medir distâncias com o Google Maps.
O que faz
Integre as APIs da Google Maps Platform ao seu fluxo. Converte endereços em coordenadas e coordenadas em endereços, traça rotas entre locais, calcula matrizes de distância, busca locais e obtém detalhes de locais, dados de altitude e informações de fuso horário.
Quando usar: Use quando o seu fluxo precisar geocodificar endereços, buscar lugares, calcular rotas e medir distâncias com o Google Maps.
Exemplo de situação: Buscar informação atual antes de formular a resposta.
Antes de começar
Conexão necessária: Credencial protegida.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Passo a passo
- Adicione Google Maps ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Converter endereço em coordenadas | Converte endereço em coordenadas com o bloco Google Maps. |
| Converter coordenadas em endereço | Converte coordenadas em endereço com o bloco Google Maps. |
| Traçar rota | Traça rota com o bloco Google Maps. |
| Calcular matriz de distâncias | Calcula matriz de distâncias com o bloco Google Maps. |
| Buscar locais | Busca locais com o bloco Google Maps. |
| Obter detalhes do local | Obtém detalhes do local com o bloco Google Maps. |
| Obter altitude | Obtém altitude com o bloco Google Maps. |
| Obter fuso horário | Obtém fuso horário com o bloco Google Maps. |
| Ajustar às vias | Ajusta às vias com o bloco Google Maps. |
| Obter limites de velocidade | Obtém limites de velocidade com o bloco Google Maps. |
| Validar endereço | Valida endereço com o bloco Google Maps. |
| Geolocalizar (Wi-Fi/rede celular) | Geolocaliza (Wi-Fi/rede celular) com o bloco Google Maps. |
| Consultar qualidade do ar | Consulta qualidade do ar com o bloco Google Maps. |
| Consultar previsão de pólen | Consulta previsão de pólen com o bloco Google Maps. |
| Consultar potencial solar | Consulta potencial solar com o bloco Google Maps. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Converter endereço em coordenadas · Converter coordenadas em endereço · Traçar rota · Calcular matriz de distâncias · Buscar locais · Obter detalhes do local · Obter altitude · Obter fuso horário · Ajustar às vias · Obter limites de velocidade · Validar endereço · Geolocalizar (Wi-Fi/rede celular) · Consultar qualidade do ar · Consultar previsão de pólen · Consultar potencial solar
- Padrão:
- Converter endereço em coordenadas
Chave de API
Obrigatório conforme a operaçãoDado protegidoInforme a sua chave de API do Google Maps.
- Quando aparece:
- Quando o campo “Operação” for diferente de “Obter limites de velocidade”
- Padrão:
- Segredo protegido
Endereço
Obrigatório conforme a operaçãoAv. Paulista, 1578, São Paulo, SP.
- Aparece em:
- Converter endereço em coordenadas
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Latitude
Obrigatório conforme a operaçãoLatitude do ponto em graus decimais, negativa ao sul da linha do Equador, usada para descobrir o endereço, a altitude ou o fuso horário (ex.: -23.5505 para São Paulo).
- Aparece em:
- Converter coordenadas em endereço, Obter altitude, Obter fuso horário
- Exemplo:
- -23.5505
Longitude
Obrigatório conforme a operaçãoLongitude do ponto em graus decimais, negativa a oeste de Greenwich, usada para descobrir o endereço, a altitude ou o fuso horário (ex.: -46.6333 para São Paulo).
- Aparece em:
- Converter coordenadas em endereço, Obter altitude, Obter fuso horário
- Exemplo:
- -46.6333
Data e hora
Em campos adicionaisData e hora no formato Unix (padrão: agora).
- Aparece em:
- Obter fuso horário
- Exemplo:
- 09:00
Origem
Obrigatório conforme a operaçãoEndereço ou coordenadas de partida (lat,lng).
- Aparece em:
- Traçar rota, Calcular matriz de distâncias
- Exemplo:
- Endereço ou coordenadas de partida (lat,lng)
Destino
Obrigatório conforme a operaçãoEndereço ou coordenadas de destino (lat,lng).
- Aparece em:
- Traçar rota
- Exemplo:
- Endereço ou coordenadas de destino (lat,lng)
Destinos
Obrigatório conforme a operaçãoEndereços de destino separados por | (ex.: São Paulo, SP|Campinas, SP).
- Aparece em:
- Calcular matriz de distâncias
- Exemplo:
- São Paulo, SP|Campinas, SP
Meio de transporte
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Traçar rota, Calcular matriz de distâncias
- Opções:
- Carro · A pé · Bicicleta · Transporte público
- Padrão:
- Carro
Evitar
Em campos adicionaisInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Traçar rota, Calcular matriz de distâncias
- Opções:
- Nenhum · Pedágios · Rodovias · Balsas
- Exemplo:
- Nenhum
Paradas intermediárias
Em campos adicionaisParadas opcionais separadas por | (ex.: Parada 1|Parada 2).
- Aparece em:
- Traçar rota
- Exemplo:
- Parada 1|Parada 2
Unidades
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Traçar rota, Calcular matriz de distâncias
- Opções:
- Métrico (km) · Imperial (milhas)
- Padrão:
- Métrico (km)
Consulta de busca
Obrigatório conforme a operaçãoInforma a consulta usada para localizar ou transformar dados.
- Aparece em:
- Buscar locais
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Localização de referência
Em campos adicionaisLatitude e longitude de referência, separadas por vírgula, para a busca dar preferência a locais próximos desse ponto (ex.: -23.5614,-46.6559, na Avenida Paulista).
- Aparece em:
- Buscar locais
- Exemplo:
- -23.5614,-46.6559
Raio (metros)
Em campos adicionaisRaio de busca em metros (ex.: 5000).
- Aparece em:
- Buscar locais
- Exemplo:
- 5000
Tipo de local
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Buscar locais
- Opções:
- Qualquer · Restaurante · Café · Bar · Hotel · Posto de combustível · Hospital · Farmácia · Banco · Caixa eletrônico · Supermercado · Shopping center · Academia · Parque · Museu · Cinema · Aeroporto · Estação de trem · Rodoviária · Estacionamento
- Exemplo:
- Qualquer
Token da página
Em campos adicionaisToken de uma busca anterior (aguarde cerca de 2 s antes de usar).
- Aparece em:
- Buscar locais
- Exemplo:
- Token de uma busca anterior (aguarde cerca de 2 s antes de usar)
ID do local
Obrigatório conforme a operaçãoID do local no Google (ex.: ChIJN1t_tDeuEmsRUsoyG83frY4).
- Aparece em:
- Obter detalhes do local
- Exemplo:
- id-do-recurso
Campos
Em campos adicionaisInforma uma estrutura JSON com os dados exigidos por esta operação.
- Aparece em:
- Obter detalhes do local
- Exemplo:
- { "chave": "valor" }
Trajeto
Obrigatório conforme a operaçãoSequência de pontos do trajeto, cada um como latitude,longitude e separados por | (ex.: -23.5614,-46.6559|-23.5629,-46.6544), na ordem em que foram percorridos.
- Aparece em:
- Ajustar às vias, Obter limites de velocidade
- Exemplo:
- /documentos/exemplo.pdf
Interpolar pontos
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Ajustar às vias
- Exemplo:
- false
IDs dos locais
Em campos adicionaisIDs de locais separados por | (alternativa ao trajeto).
- Aparece em:
- Obter limites de velocidade
- Exemplo:
- IDs de locais separados por | (alternativa ao trajeto)
Unidade de velocidade
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Obter limites de velocidade
- Opções:
- km/h · mph
- Padrão:
- km/h
Endereço
Obrigatório conforme a operaçãoAv. Paulista, 1578, São Paulo, SP, 01310-200.
- Aparece em:
- Validar endereço
- Exemplo:
- 2026-09-15
Código da região
Em campos adicionaisCódigo ISO do país (ex.: BR, US, PT).
- Aparece em:
- Validar endereço
- Exemplo:
- BR, US, PT
Cidade
Em campos adicionaisNome da cidade (dica opcional).
- Aparece em:
- Validar endereço
- Exemplo:
- Nome da cidade (dica opcional)
Ativar USPS CASS
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Validar endereço
- Exemplo:
- false
Usar endereço IP
Ativa ou desativa este comportamento.
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- false
Tipo de rede móvel
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Opções:
- Nenhum · LTE · GSM · CDMA · WCDMA · 5G NR
- Exemplo:
- Nenhum
Operadora
Em campos adicionaisNome da operadora.
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- Nome da operadora
Código do país da rede de origem (MCC)
Em campos adicionaisMCC da rede de origem (ex.: 724).
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- +5511999999999
Código da rede móvel de origem (MNC)
Em campos adicionaisMNC da rede de origem (ex.: 05).
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- +5511999999999
Pontos de acesso Wi-Fi
Em campos adicionaisLista em JSON das redes Wi-Fi que o aparelho enxerga, com pelo menos o endereço MAC de cada uma, para o Google estimar onde ele está.
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- Lista JSON de pontos de acesso Wi-Fi: [{"macAddress": "..."}]
Torres de celular
Em campos adicionaisLista em JSON das torres de celular a que o aparelho está conectado, com o ID da célula e o código de área de cada uma, para o Google estimar onde ele está.
- Aparece em:
- Geolocalizar (Wi-Fi/rede celular)
- Exemplo:
- Lista JSON de torres de celular: [{"cellId": ..., "locationAreaCode": ...}]
Latitude
Obrigatório conforme a operaçãoLatitude do local em graus decimais, usada para consultar qualidade do ar, pólen, potencial solar ou lugares próximos (ex.: -23.5505 para São Paulo).
- Aparece em:
- Consultar qualidade do ar, Consultar previsão de pólen, Consultar potencial solar
- Exemplo:
- -23.5505
Longitude
Obrigatório conforme a operaçãoLongitude do local em graus decimais, usada para consultar qualidade do ar, pólen, potencial solar ou lugares próximos (ex.: -46.6333 para São Paulo).
- Aparece em:
- Consultar qualidade do ar, Consultar previsão de pólen, Consultar potencial solar
- Exemplo:
- -46.6333
Código do idioma
Em campos adicionaisDefine o idioma do modelo ou conteúdo, como pt_BR ou en_US, no formato aceito pelo serviço.
- Aparece em:
- Consultar qualidade do ar, Consultar previsão de pólen
- Exemplo:
- pt-BR
Dias de previsão
Em campos adicionaisNúmero de dias (1 a 5; padrão: 1).
- Aparece em:
- Consultar previsão de pólen
- Exemplo:
- Número de dias (1 a 5; padrão: 1)
Incluir descrição das plantas
Em campos adicionaisInforma o conteúdo de texto que será enviado ou processado.
- Aparece em:
- Consultar previsão de pólen
- Exemplo:
- false
Qualidade mínima das imagens
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Consultar potencial solar
- Opções:
- Qualquer · Alta · Média · Base
- Exemplo:
- Qualquer
Idioma
Em campos adicionaisCódigo do idioma (ex.: pt-BR, en, es, fr).
- Aparece em:
- Converter endereço em coordenadas, Converter coordenadas em endereço, Traçar rota, Calcular matriz de distâncias, Buscar locais, Obter detalhes do local, Obter fuso horário
- Exemplo:
- pt-BR
Região de referência
Em campos adicionaisCódigo do país (ex.: br, us, pt).
- Aparece em:
- Converter endereço em coordenadas, Buscar locais
- Exemplo:
- br, us, pt
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googlemaps.formattedAddress>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<googlemaps.formattedAddress> | string | Endereço formatado. |
<googlemaps.lat> | number | Latitude. |
<googlemaps.lng> | number | Longitude. |
<googlemaps.placeId> | string | ID do local no Google. |
<googlemaps.addressComponents> | json | Partes detalhadas do endereço. |
<googlemaps.locationType> | string | Tipo de precisão da localização. |
<googlemaps.types> | json | Tipos de endereço ou de local. |
<googlemaps.routes> | json | Rotas disponíveis. |
<googlemaps.distanceText> | string | Distância em texto (ex.: "5,2 km"). |
<googlemaps.distanceMeters> | number | Distância em metros. |
<googlemaps.durationText> | string | Duração em texto (ex.: "15 min"). |
<googlemaps.durationSeconds> | number | Duração em segundos. |
<googlemaps.startAddress> | string | Endereço de partida. |
<googlemaps.endAddress> | string | Endereço de chegada. |
<googlemaps.steps> | json | Instruções passo a passo. |
<googlemaps.polyline> | string | Polilinha codificada da rota. |
<googlemaps.rows> | json | Linhas da matriz de distâncias. |
<googlemaps.originAddresses> | json | Endereços de origem identificados. |
<googlemaps.destinationAddresses> | json | Endereços de destino identificados. |
<googlemaps.places> | json | Lista de locais encontrados. |
<googlemaps.nextPageToken> | string | Token da próxima página de resultados. |
<googlemaps.name> | string | Nome do local. |
<googlemaps.rating> | number | Avaliação do local (1 a 5). |
<googlemaps.userRatingsTotal> | number | Número de avaliações de usuários. |
<googlemaps.priceLevel> | number | Nível de preço (0 a 4). |
<googlemaps.website> | string | Site do local. |
<googlemaps.phoneNumber> | string | Telefone do local. |
<googlemaps.internationalPhoneNumber> | string | Telefone em formato internacional. |
<googlemaps.openNow> | boolean | Indica se o local está aberto agora. |
<googlemaps.weekdayText> | json | Horário de funcionamento por dia. |
<googlemaps.reviews> | json | Avaliações do local. |
<googlemaps.photos> | json | Fotos do local. |
<googlemaps.url> | string | URL do local no Google Maps. |
<googlemaps.vicinity> | string | Endereço simplificado. |
<googlemaps.elevation> | number | Altitude em metros. |
<googlemaps.resolution> | number | Resolução dos dados em metros. |
<googlemaps.timeZoneId> | string | ID do fuso horário (ex.: America/Sao_Paulo). |
<googlemaps.timeZoneName> | string | Nome do fuso horário. |
<googlemaps.rawOffset> | number | Diferença em relação ao UTC, em segundos (sem horário de verão). |
<googlemaps.dstOffset> | number | Ajuste do horário de verão, em segundos. |
<googlemaps.snappedPoints> | json | Coordenadas ajustadas às vias. |
<googlemaps.warningMessage> | string | Mensagem de aviso, se houver. |
<googlemaps.speedLimits> | json | Limites de velocidade por trecho da via. |
<googlemaps.addressComplete> | boolean | Indica se o endereço está completo. |
<googlemaps.hasUnconfirmedComponents> | boolean | Indica se há partes não confirmadas. |
<googlemaps.hasInferredComponents> | boolean | Indica se há partes deduzidas. |
<googlemaps.hasReplacedComponents> | boolean | Indica se há partes substituídas. |
<googlemaps.validationGranularity> | string | Nível de detalhe da validação. |
<googlemaps.geocodeGranularity> | string | Nível de detalhe da geocodificação. |
<googlemaps.missingComponentTypes> | json | Tipos de partes do endereço que estão faltando. |
<googlemaps.unconfirmedComponentTypes> | json | Tipos de partes não confirmadas. |
<googlemaps.unresolvedTokens> | json | Trechos da entrada que não foram reconhecidos. |
<googlemaps.accuracy> | number | Precisão da localização em metros. |
<googlemaps.dateTime> | string | Data e hora dos dados de qualidade do ar. |
<googlemaps.regionCode> | string | Código da região. |
<googlemaps.indexes> | json | Índices de qualidade do ar. |
<googlemaps.pollutants> | json | Concentração de poluentes. |
<googlemaps.healthRecommendations> | json | Recomendações de saúde. |
<googlemaps.dailyInfo> | json | Previsão diária de pólen (gramíneas, árvores, ervas daninhas e plantas). |
<googlemaps.center> | json | Coordenada central do edifício analisado. |
<googlemaps.imageryDate> | json | Data em que as imagens solares foram captadas. |
<googlemaps.imageryQuality> | string | Qualidade das imagens solares usadas. |
<googlemaps.postalCode> | string | CEP do edifício analisado. |
<googlemaps.administrativeArea> | string | Região administrativa do edifício analisado. |
<googlemaps.solarPotential> | json | Potencial solar, especificações dos painéis e configurações. |
Exemplo de uso
Objetivo: Buscar informação atual antes de formular a resposta.
- Operação
- Converter endereço em coordenadas
- Endereço
- Avenida Paulista, 1000, São Paulo - SP
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googlemaps.formattedAddress>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Credencial ausente ou recusada
- Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Busca na webPesquisar informações atuais na web e devolver fontes para o fluxo.
- Buscar imagens · Google SearchBuscar imagens usando a conexão Google Search deste workspace.
- Buscar páginas na web · Google SearchBuscar páginas na web usando a conexão Google Search deste workspace.
- Google SearchPesquisar informações públicas na web com o Google Search.
- WikipédiaPesquisar e recuperar conteúdo público da Wikipédia.
- Acrescentar dados · Google SheetsAcrescentar dados usando a conexão Google Sheets deste workspace.