Conecta-seEntrar na plataforma

Google Maps

Geocodificar endereços, buscar lugares, calcular rotas e medir distâncias com o Google Maps.

Integrações e ferramentasPesquisaConexão: Credencial protegida

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

  1. Adicione Google Maps ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Converter endereço em coordenadasConverte endereço em coordenadas com o bloco Google Maps.
Converter coordenadas em endereçoConverte coordenadas em endereço com o bloco Google Maps.
Traçar rotaTraça rota com o bloco Google Maps.
Calcular matriz de distânciasCalcula matriz de distâncias com o bloco Google Maps.
Buscar locaisBusca locais com o bloco Google Maps.
Obter detalhes do localObtém detalhes do local com o bloco Google Maps.
Obter altitudeObtém altitude com o bloco Google Maps.
Obter fuso horárioObtém fuso horário com o bloco Google Maps.
Ajustar às viasAjusta às vias com o bloco Google Maps.
Obter limites de velocidadeObtém limites de velocidade com o bloco Google Maps.
Validar endereçoValida 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 arConsulta qualidade do ar com o bloco Google Maps.
Consultar previsão de pólenConsulta previsão de pólen com o bloco Google Maps.
Consultar potencial solarConsulta potencial solar com o bloco Google Maps.

Campos

Mostrar campos de
  • 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 protegido

    Informe 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ção

    Av. 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ção

    Latitude 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ção

    Longitude 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 adicionais

    Data e hora no formato Unix (padrão: agora).

    Aparece em:
    Obter fuso horário
    Exemplo:
    09:00
  • Origem

    Obrigatório conforme a operação

    Endereç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ção

    Endereç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ção

    Endereç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 adicionais

    Informa 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 adicionais

    Paradas opcionais separadas por | (ex.: Parada 1|Parada 2).

    Aparece em:
    Traçar rota
    Exemplo:
    Parada 1|Parada 2
  • Unidades

    Em campos adicionais

    Escolhe 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ção

    Informa 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 adicionais

    Latitude 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 adicionais

    Raio de busca em metros (ex.: 5000).

    Aparece em:
    Buscar locais
    Exemplo:
    5000
  • Tipo de local

    Em campos adicionais

    Escolhe 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 adicionais

    Token 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ção

    ID do local no Google (ex.: ChIJN1t_tDeuEmsRUsoyG83frY4).

    Aparece em:
    Obter detalhes do local
    Exemplo:
    id-do-recurso
  • Campos

    Em campos adicionais

    Informa 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ção

    Sequê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 adicionais

    Ativa ou desativa este comportamento.

    Aparece em:
    Ajustar às vias
    Exemplo:
    false
  • IDs dos locais

    Em campos adicionais

    IDs 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 adicionais

    Escolhe 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ção

    Av. Paulista, 1578, São Paulo, SP, 01310-200.

    Aparece em:
    Validar endereço
    Exemplo:
    2026-09-15
  • Código da região

    Em campos adicionais

    Código ISO do país (ex.: BR, US, PT).

    Aparece em:
    Validar endereço
    Exemplo:
    BR, US, PT
  • Cidade

    Em campos adicionais

    Nome da cidade (dica opcional).

    Aparece em:
    Validar endereço
    Exemplo:
    Nome da cidade (dica opcional)
  • Ativar USPS CASS

    Em campos adicionais

    Ativa 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 adicionais

    Escolhe 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 adicionais

    Nome 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 adicionais

    MCC 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 adicionais

    MNC da rede de origem (ex.: 05).

    Aparece em:
    Geolocalizar (Wi-Fi/rede celular)
    Exemplo:
    +5511999999999
  • Pontos de acesso Wi-Fi

    Em campos adicionais

    Lista 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 adicionais

    Lista 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ção

    Latitude 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ção

    Longitude 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 adicionais

    Define 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 adicionais

    Nú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 adicionais

    Informa 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 adicionais

    Escolhe 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 adicionais

    Có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 adicionais

    Có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ênciaTipoO que contém
<googlemaps.formattedAddress>stringEndereço formatado.
<googlemaps.lat>numberLatitude.
<googlemaps.lng>numberLongitude.
<googlemaps.placeId>stringID do local no Google.
<googlemaps.addressComponents>jsonPartes detalhadas do endereço.
<googlemaps.locationType>stringTipo de precisão da localização.
<googlemaps.types>jsonTipos de endereço ou de local.
<googlemaps.routes>jsonRotas disponíveis.
<googlemaps.distanceText>stringDistância em texto (ex.: "5,2 km").
<googlemaps.distanceMeters>numberDistância em metros.
<googlemaps.durationText>stringDuração em texto (ex.: "15 min").
<googlemaps.durationSeconds>numberDuração em segundos.
<googlemaps.startAddress>stringEndereço de partida.
<googlemaps.endAddress>stringEndereço de chegada.
<googlemaps.steps>jsonInstruções passo a passo.
<googlemaps.polyline>stringPolilinha codificada da rota.
<googlemaps.rows>jsonLinhas da matriz de distâncias.
<googlemaps.originAddresses>jsonEndereços de origem identificados.
<googlemaps.destinationAddresses>jsonEndereços de destino identificados.
<googlemaps.places>jsonLista de locais encontrados.
<googlemaps.nextPageToken>stringToken da próxima página de resultados.
<googlemaps.name>stringNome do local.
<googlemaps.rating>numberAvaliação do local (1 a 5).
<googlemaps.userRatingsTotal>numberNúmero de avaliações de usuários.
<googlemaps.priceLevel>numberNível de preço (0 a 4).
<googlemaps.website>stringSite do local.
<googlemaps.phoneNumber>stringTelefone do local.
<googlemaps.internationalPhoneNumber>stringTelefone em formato internacional.
<googlemaps.openNow>booleanIndica se o local está aberto agora.
<googlemaps.weekdayText>jsonHorário de funcionamento por dia.
<googlemaps.reviews>jsonAvaliações do local.
<googlemaps.photos>jsonFotos do local.
<googlemaps.url>stringURL do local no Google Maps.
<googlemaps.vicinity>stringEndereço simplificado.
<googlemaps.elevation>numberAltitude em metros.
<googlemaps.resolution>numberResolução dos dados em metros.
<googlemaps.timeZoneId>stringID do fuso horário (ex.: America/Sao_Paulo).
<googlemaps.timeZoneName>stringNome do fuso horário.
<googlemaps.rawOffset>numberDiferença em relação ao UTC, em segundos (sem horário de verão).
<googlemaps.dstOffset>numberAjuste do horário de verão, em segundos.
<googlemaps.snappedPoints>jsonCoordenadas ajustadas às vias.
<googlemaps.warningMessage>stringMensagem de aviso, se houver.
<googlemaps.speedLimits>jsonLimites de velocidade por trecho da via.
<googlemaps.addressComplete>booleanIndica se o endereço está completo.
<googlemaps.hasUnconfirmedComponents>booleanIndica se há partes não confirmadas.
<googlemaps.hasInferredComponents>booleanIndica se há partes deduzidas.
<googlemaps.hasReplacedComponents>booleanIndica se há partes substituídas.
<googlemaps.validationGranularity>stringNível de detalhe da validação.
<googlemaps.geocodeGranularity>stringNível de detalhe da geocodificação.
<googlemaps.missingComponentTypes>jsonTipos de partes do endereço que estão faltando.
<googlemaps.unconfirmedComponentTypes>jsonTipos de partes não confirmadas.
<googlemaps.unresolvedTokens>jsonTrechos da entrada que não foram reconhecidos.
<googlemaps.accuracy>numberPrecisão da localização em metros.
<googlemaps.dateTime>stringData e hora dos dados de qualidade do ar.
<googlemaps.regionCode>stringCódigo da região.
<googlemaps.indexes>jsonÍndices de qualidade do ar.
<googlemaps.pollutants>jsonConcentração de poluentes.
<googlemaps.healthRecommendations>jsonRecomendações de saúde.
<googlemaps.dailyInfo>jsonPrevisão diária de pólen (gramíneas, árvores, ervas daninhas e plantas).
<googlemaps.center>jsonCoordenada central do edifício analisado.
<googlemaps.imageryDate>jsonData em que as imagens solares foram captadas.
<googlemaps.imageryQuality>stringQualidade das imagens solares usadas.
<googlemaps.postalCode>stringCEP do edifício analisado.
<googlemaps.administrativeArea>stringRegião administrativa do edifício analisado.
<googlemaps.solarPotential>jsonPotencial solar, especificações dos painéis e configurações.

Exemplo de uso

Objetivo: Buscar informação atual antes de formular a resposta.

InícioGoogle Mapspróxima etapa
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