Pular para as operações

Verificação de endereço

Google Maps em um fluxo de decisão.

2 Google Maps operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Verificação de endereço
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

Google's geocoding and places APIs.

O Google Maps Platform é o lado pago das APIs do Google Maps: transformar um endereço em coordenadas e em forma canônica, geocodificação reversa, busca de lugares e rotas. Para uma decisão, a parte útil é a normalização — transformar o que o solicitante digitou em um endereço que outros sistemas aceitam.

O que um fluxo pode chamar

2 operações, cada uma um passo que você coloca no editor.

  1. GET/maps/api/geocode/json?address=$data.applicant_address&components=country:$data.applicant_country_code

    Validar e geocodificar um endereço

    Resolve um endereço postal em componentes estruturados e coordenadas.

  2. GET/maps/api/geocode/json?latlng=$data.latitude,$data.longitude

    Validar coordenadas contra um endereço

    Converte coordenadas capturadas em um endereço estruturado.

Onde isso entra na decisão

Address verification calls have a natural place in a flow.

O endereço é uma entrada em que outros sistemas vão confiar, então vale resolvê-lo para uma forma canônica antes de ele virar um campo em um cadastro de crédito ou em um registro de KYC. A chamada é barata e cabe cedo, enquanto corrigir a entrada ainda sai de graça.

Whatever Google Maps returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Google Maps as a connection authenticating with an API key.
  • 02A Google Maps tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Validar e geocodificar um endereço” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Google Maps em um fluxo.

Como conecto a Google Maps a um fluxo de decisão?

Adicione a Google Maps como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Google Maps em uma decisão sem nunca ver o segredo.

Dá para testar a Google Maps sem tocar em produção?

A Google Maps expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Google Maps?

2 operações: “Validar e geocodificar um endereço”, “Validar coordenadas contra um endereço”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Validar e geocodificar um endereço”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Google Maps deve ser chamada?

O endereço é uma entrada em que outros sistemas vão confiar, então vale resolvê-lo para uma forma canônica antes de ele virar um campo em um cadastro de crédito ou em um registro de KYC. A chamada é barata e cabe cedo, enquanto corrigir a entrada ainda sai de graça.

Quando você quiser

Wire Google Maps into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação