Captura e validação de endereço

O kit de ferramentas da solução Last Mile Fleet da Plataforma Google Maps oferece serviços que resolvem vários problemas comuns com o endereçamento de entregas: inserção incorreta de endereços de consumidores, endereços não entregues e ajustes nos locais dos pontos de entrega.

Esses serviços incluem o seguinte:

  • API Places: simplifica a inserção de endereços para usuários finais e fornece informações sobre pontos de interesse que podem ser usados para fins de definição de trajeto.
  • API Address Validation: determina se um endereço se refere a um local de entrega real e fornece metadados adicionais no nível do endereço.
  • API Geocoding: informa a latitude/longitude de um determinado endereço.

Neste documento, descrevemos como usar esses serviços.

Sobre a captura e a validação de endereço

Informações de endereço precisas e detalhadas são essenciais para operações de entrega, porque afetam a qualidade de todas as atividades downstream que dependem delas. Se você recebe endereços por meio de um aplicativo voltado ao usuário ou de parceiros upstream por meio de uma API, a Last Mile Fleet Solution pode ajudar nessa etapa.

Ao verificar se um endereço está correto, você:

  • Melhorar a experiência do consumidor: forneça aos seus usuários as ferramentas para garantir que eles possam informar facilmente um endereço correto e que os pacotes sejam entregues no lugar certo.

  • Melhorar a produtividade dos motoristas: reduza o tempo que os motoristas passam pesquisando endereços de entrega e reduza a necessidade de repetir tentativas de entrega.

Capturar o endereço

A API Places contém o serviço Place Autocomplete. Esse serviço oferece a funcionalidade de preenchimento automático para pesquisas geográficas baseadas em texto ao retornar lugares, como empresas, endereços e pontos de interesse, à medida que o usuário insere um endereço.

Em aplicativos voltados ao usuário que envolvem a obtenção de um endereço de entrega, como um site on-line de consumidores ou remetentes ou um portal para funcionários na loja, simplifique a entrada e a seleção de endereços para seus clientes usando o Place Autocomplete.

Por exemplo, imagine que um usuário solicite a retirada de um pacote e insira o local de retirada. Com o Place Autocomplete, é mais fácil fornecer um endereço. Basta inserir alguns caracteres e selecionar uma opção em uma lista correspondente.

A API Places também oferece maneiras de restringir os resultados da pesquisa. Assim, os desenvolvedores podem garantir que os endereços sugeridos estejam alinhados aos locais que sua empresa atende.

Valide o endereço

Depois de capturar um endereço, seja por entrada direta do usuário ou por uma API, verifique se o cliente informou um endereço correto. ou seja, um endereço sem imprecisões, como componentes ou erros de digitação. A validação de endereços ajuda a reduzir as falhas de entrega identificando endereços incorretos e melhora a previsibilidade das entregas com mais informações sobre os detalhes do endereço.

A API Address Validation valida os componentes de endereço, normaliza o endereço para correspondência e encontra o local mais conhecido para ele. Pode ajudar a entender se um endereço se refere a um lugar real. Se o endereço não se referir a um local real, ele poderá identificar componentes possivelmente errados, permitindo que os usuários os corrijam.

Se a API Address Validation determinar que o endereço está incorreto ou se refere a um local onde não é possível entregar, você pode solicitar que o usuário o corrija. Se você conseguir o endereço por meio de uma chamada de API, poderá rejeitá-lo.

Permitir a confirmação do local do endereço

Depois que um usuário inserir ou selecionar um endereço e você validá-lo, use a Plataforma Google Maps para fornecer um mapa e um marcador indicando a localização do endereço.

Use a API Geocoding para determinar as coordenadas geográficas do endereço. Além do local, a API Geocoding também retorna componentes de endereço que permitem receber partes ausentes do endereço necessárias para as correções necessárias. Essa função também fornece o tipo de localização, que indica a precisão das coordenadas recuperadas da API.

O local geocodificado também pode ser usado para outras finalidades, como atribuir a entrega a um motorista na sequência ideal. Consulte Otimização de rotas para mais detalhes.

Use os serviços da Last Mile Fleet Solution para registrar endereços

Esta seção fornece informações básicas sobre como implementar a captura e a validação de endereços. Estas etapas pressupõem que você configurou um projeto no Console de APIs do Google e ativou as contas de serviço e o faturamento corretos. Para detalhes específicos da solução Last Mile Fleet, consulte a documentação do Fleet Engine para configurar seu projeto.

Ative a inserção fácil de endereços

  1. Ative a API Places na seção "APIs e serviços" do Console de APIs do Google. A API Places inclui o serviço Place Autocomplete.
  2. Consulte a documentação do Place Autocomplete para conferir outros recursos que você pode usar, como a seção Parâmetros opcionais. Por exemplo:
    • O parâmetro de componentes limita a saída a determinados países.
    • O parâmetro "types" restringe os resultados a determinados tipos de localização, como endereços e até idiomas de entrada permitidos pelo usuário.
  3. Para facilitar a implantação de um formulário de endereço, a Plataforma Google Maps oferece um Criador rápido de soluções no Console de APIs do Google.

Validar o endereço de entrega

  1. Ative a API Address Validation na seção "APIs e serviços" do Console de APIs do Google.
  2. Leia a documentação da API Address Validation para entender os diversos dados que podem ser usados para avaliar a qualidade do endereço e mostrar recomendações para os usuários.

Permitir a confirmação do local de retirada ou entrega

  1. Crie um mapa interativo para os usuários nas suas plataformas preferidas para dispositivos móveis e Web. Para mais detalhes, consulte a documentação da API Maps JavaScript e acesse as instruções de outras plataformas.
  2. Consiga o geocódigo do endereço na API Address Validation ou transmita o ID do lugar do Place Autocomplete para a API Geocoding e adicione um marcador no local.
  3. Para permitir que o usuário ajuste as coordenadas de exibição, torne os marcadores arrastáveis. Consulte a documentação para saber mais sobre comportamentos dos marcadores (Android, iOS e Web).
  4. Recuperar o geocódigo da posição ajustada do marcador. Também é possível transmitir o geocódigo atualizado à API Geocoding Reversa para recuperar o endereço correspondente. Em seguida, você pode avaliar os componentes do endereço e a precisão da nova posição.

Conseguir mais contexto sobre os endereços de entrega

Ter dados contextuais detalhados sobre endereços de entrega é uma próxima etapa essencial depois que um endereço é determinado. Com essas informações, você pode:

  • Melhorar a produtividade dos motoristas: garanta que os motoristas tenham todas as informações para concluir as entregas com eficiência e sucesso. Quando combinado com outros recursos da Last Mile Fleet Solution, você garante que os motoristas cheguem ao lugar certo na hora certa.
  • Reduzir custos: levar o motorista ao lugar certo de maneira eficiente e reduzir entregas repetidas também pode reduzir os custos de mão de obra e combustível da sua frota.
  • Escalone suas operações com facilidade: todos os recursos de captura de endereços usam o banco de dados geoespacial mundial do Google, que oferece cobertura granular onde quer que você expanda seus negócios.

Os serviços da Last Mile Fleet Solution podem ser usados para receber vários dados contextuais sobre endereços e locais. Depois de determinar o endereço correto, você pode chamar qualquer um dos serviços abaixo para receber as informações relevantes. Essas informações podem ser usadas como entrada nos seus sistemas de otimização de trajetos ou para fornecer mais contexto aos motoristas no aplicativo de motorista.

  • A API Geocoding tenta associar um endereço de entrada a um local usando o banco de dados do Google Maps e informa a latitude/longitude.
  • Além de fornecer vários sinais de validação, a API Address Validation também fornece a latitude/longitude do endereço de entrada. Ele também fornece bandeiras residenciais e comerciais para o local e uma variedade de dados do USPS para endereços nos EUA.
  • A API Place Details fornece informações sobre pontos de interesse, incluindo o horário de funcionamento da empresa.

Consulte as seções acima para saber como ativar e começar a usar as várias APIs.