A captura e validação de endereços é um kit de ferramentas de serviços de mobilidade que ajuda a resolver vários problemas comuns com endereços de entrega, como entrada de endereço imprecisa por consumidores, endereços não entregáveis e a necessidade de ajustes nos locais de entrega.
Esses serviços incluem o seguinte:
- API Places (nova): 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 real de entrega e fornece metadados adicionais no nível do endereço.
- API Geocoding: fornece a latitude e a longitude de um determinado endereço.
Este documento descreve como usar esses serviços.
Sobre a captura e validação de endereços
Informações de endereço precisas e detalhadas são essenciais para as operações de entrega, porque afetam a qualidade de todas as atividades subsequentes que dependem delas. Se você recebe endereços por um aplicativo voltado ao usuário ou de parceiros upstream usando uma API, os serviços de mobilidade do Google podem ajudar nessa etapa.
Seja por um aplicativo voltado ao usuário ou por parceiros upstream que usam uma API, os serviços de mobilidade do Google podem ajudar você a capturar endereços da seguinte maneira:
Melhorar a experiência do consumidor:ofereça aos usuários as ferramentas para garantir que eles informem um endereço correto e que os pacotes sejam entregues no lugar certo.
Melhorar a produtividade dos motoristas:reduza o tempo que eles gastam procurando endereços de entrega e a necessidade de novas tentativas.
Capturar o endereço
A API Places (nova) contém o serviço Autocomplete (novo). Esse serviço oferece recursos de preenchimento automático para pesquisas geográficas baseadas em texto, retornando 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 consumidor ou transportadora on-line ou um portal de funcionários na loja, simplifique a entrada e a seleção de endereços para seus clientes usando o Autocomplete (New).
Por exemplo, imagine que um usuário solicita a retirada de um pacote e insere o local de retirada. Com o preenchimento automático (novo), é possível fornecer um endereço digitando alguns caracteres e selecionando em uma lista correspondente.
A API Places (New) também oferece maneiras de restringir os resultados da pesquisa para que os desenvolvedores garantam que os endereços sugeridos estejam alinhados com os locais atendidos pela sua empresa.
Validar o endereço
Depois de capturar um endereço, seja por entrada direta do usuário ou usando uma API, confirme se o cliente forneceu um endereço correto. Isso significa um endereço sem imprecisões, como componentes ausentes ou erros de digitação. A validação de endereço ajuda a reduzir falhas de entrega ao detectar endereços inválidos e melhora a previsibilidade da entrega com um melhor conhecimento dos detalhes do endereço.
A API Address Validation valida os componentes do 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 lugar 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 não entregável, peça ao usuário para corrigir o problema. Se você receber o endereço usando uma chamada de API, poderá rejeitá-lo.
Permitir a confirmação da localização do endereço
Depois que um usuário inserir ou selecionar um endereço e você o validar, use a Plataforma Google Maps para fornecer um mapa e um marcador que indiquem o local do endereço.
Use a API Geocoding para determinar as coordenadas geográficas do endereço. Além da localização, a API Geocoding também retorna componentes de endereço, que podem ser usados para receber as partes ausentes necessárias para correções. Ele também fornece o tipo de local, que indica a precisão das coordenadas recuperadas da API.
A localização geocodificada também pode ser usada para outras finalidades, como atribuir a entrega a um motorista na sequência ideal. Consulte Otimização de rotas para mais detalhes.
Usar os serviços de mobilidade do Google para captura de 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 tem as contas de serviço e o faturamento corretos ativados. Para detalhes específicos dos serviços de mobilidade do Google, consulte a documentação do Fleet Engine (em inglês) para configurar seu projeto.
Ativar recursos de entrada de endereço
- Ative a API Places (nova) na seção "APIs e serviços" do console de APIs do Google. A API Places (nova) inclui o serviço Autocomplete (novo).
- Consulte a documentação do Autocomplete (novo) para conhecer outros recursos que você pode usar, como a seção Parâmetros opcionais. Exemplo:
- O parâmetro "components" limita a saída a determinados países.
- O parâmetro "types" restringe os resultados a determinados tipos de locais, como endereços e até mesmo idiomas de entrada permitidos do usuário.
- Para simplificar 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
- Ative a API Address Validation na seção "APIs e serviços" do console de APIs do Google.
- Consulte a documentação da API Address Validation para entender os vários dados que podem ser usados para avaliar a qualidade do endereço e mostrar recomendações aos usuários.
Permitir a confirmação do local de retirada ou entrega
- Crie um mapa interativo para seus usuários nas plataformas de sua preferência para dispositivos móveis e Web. Para mais detalhes, consulte a documentação da API Maps JavaScript e navegue até as instruções de outras plataformas.
- Receba o geocódigo do endereço da API Address Validation ou transmitindo o ID de lugar do preenchimento automático (novo) para a API Geocoding e adicione um marcador no local.
- Para permitir que o usuário ajuste as coordenadas de entrega, faça com que os marcadores possam ser arrastados. Consulte a documentação sobre comportamentos de marcadores (Android, iOS, Web).
- Recupere o geocódigo da posição ajustada do marcador. Você também pode transmitir o geocódigo atualizado para a API Reverse Geocoding e recuperar o endereço correspondente. Em seguida, avalie os componentes de endereço e a precisão da nova posição.
Receber mais contexto sobre os endereços de entrega
Ter dados de contexto detalhados sobre endereços de entrega é uma etapa essencial depois que um endereço é determinado. Com essas informações, é possível:
- Melhorar a produtividade dos motoristas: garanta que os motoristas tenham todas as informações necessárias para concluir as entregas com sucesso e eficiência. Quando combinadas com outros recursos dos Serviços de mobilidade do Google, você garante que os motoristas cheguem ao lugar certo na hora certa.
- Reduzir custos: levar o motorista ao lugar certo e reduzir as entregas repetidas também pode diminuir os custos de mão de obra e combustível da sua frota.
- Escalone suas operações: todos os recursos de captura de endereços usam o banco de dados geoespacial mundial do Google, que oferece cobertura granular em qualquer lugar que você expanda sua empresa.
Os serviços de mobilidade do Google podem ser usados para obter uma variedade de dados de contexto sobre endereços e locais. Depois de determinar o endereço correto, ligue para qualquer um dos serviços descritos abaixo para receber as informações relevantes. Essas informações podem ser usadas como entrada nos seus sistemas de otimização de rotas ou para fornecer mais contexto aos motoristas no aplicativo deles.
- A API Geocoding tenta corresponder 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 indicadores de validação, a API Address Validation também fornece a latitude/longitude do endereço inserido. Ele também fornece indicadores residenciais e comerciais para o local e uma variedade de dados dos Correios para endereços dos EUA.
- A API Place Details fornece informações sobre pontos de interesse, incluindo o horário de funcionamento das empresas.