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 entrega: inserção imprecisa de endereços dos consumidores, impossibilidade de entrega e ajustes nos locais de entrega.

Esses serviços incluem o seguinte:

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

Este documento descreve como usar esses serviços.

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

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 garantir que o endereço informado está correto, você:

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

  • Melhorar a produtividade do motorista: reduza o tempo que os motoristas passam procurando endereços de entrega e a necessidade de repetições de entregas.

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, enquanto o usuário digita um endereço.

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

Por exemplo, suponha que um usuário solicite a retirada de um pacote e insira o local de retirada. Com o Place Autocomplete, é mais fácil indicar 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, para que os desenvolvedores possam garantir que os endereços sugeridos estejam alinhados com os 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 forneceu um endereço correto. Isso significa que o endereço está livre de erros, como componentes faltando ou erros de digitação. A validação de endereço ajuda a reduzir falhas de entrega, capturando endereços incorretos e melhora a previsibilidade de entrega com melhor reconhecimento dos detalhes do endereço.

A API Address Validation valida os componentes de endereço, normaliza o endereço de 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 refere a um lugar real, ele pode 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 que não pode ser entregue, peça para o usuário corrigir o problema. 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 encontrar as partes ausentes do endereço necessárias para as correções necessárias. Ele também fornece o tipo de local, que indica a precisão das coordenadas recuperadas da API.

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

Usar os serviços da Last Mile Fleet Solution para capturar endereços

Nesta seção, você encontra 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 da Last Mile Fleet, consulte a documentação do Fleet Engine para configurar o projeto.

Ativar a entrada 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 conhecer outros recursos que podem ser usados, 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é os idiomas de entrada permitidos do 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.

Valide 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 vários dados que você pode usar para avaliar a qualidade do endereço e mostrar recomendações aos 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. Acesse o geocódigo de endereço usando a 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 entrega, torne os marcadores arrastáveis. Consulte a documentação sobre os comportamentos dos marcadores (Android, iOS e Web).
  4. Recupere o geocódigo da posição ajustada do marcador. Você também pode transmitir o geocódigo atualizado para a API Geocoding inversa para recuperar o endereço correspondente. Assim, você pode avaliar os componentes de endereço e a precisão da nova posição.

Confira 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 for determinado. Com essas informações, é possível:

  • Melhorar a produtividade dos motoristas: garanta que os motoristas tenham todas as informações para concluir as entregas com eficiência. Quando combinado com outros recursos da solução Last Mile Fleet, você garante que os motoristas cheguem ao lugar certo na hora certa.
  • Reduzir custos: levar o motorista ao lugar certo com eficiência e reduzir as entregas repetidas também pode reduzir os custos de mão de obra e combustível da frota.
  • Dimensione suas operações com facilidade: todos os recursos de captura de endereço usam o banco de dados geoespacial global do Google, que oferece cobertura granular para 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 conseguir as informações relevantes. Essas informações podem ser usadas como entrada para seus sistemas de otimização de rotas ou para fornecer mais contexto aos motoristas no aplicativo do motorista.

  • A API Geocoding tenta associar um endereço de entrada a um local com o banco de dados do Google Maps e fornece 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 do local e uma variedade de dados da USPS para endereços nos EUA.
  • A API Place Details fornece informações sobre pontos de interesse, incluindo o horário de funcionamento.

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