O recurso de 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: 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 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.
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 na captura de 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 os motoristas gastam procurando endereços de entrega e a necessidade de novas tentativas de entrega.
Capture o endereço
A API Places contém o serviço Place Autocomplete. 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 à medida que 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 transportador 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 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, é possível fornecer um endereço digitando apenas alguns caracteres e selecionando em uma lista correspondente.
A API Places também oferece maneiras de restringir os resultados da pesquisa para que seus desenvolvedores possam garantir 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, verifique 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. Isso ajuda 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 de entrega impossí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.
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.
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 para configurar seu projeto.
Ativar recursos de entrada de endereço
- 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.
- Consulte a documentação do Place Autocomplete para conhecer outros recursos que podem ser usados, 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 Place Autocomplete para a API Geocoding e adicione um marcador no local.
- Para permitir que o usuário ajuste as coordenadas de entrega, torne os marcadores arrastáveis. 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 contextuais detalhados sobre endereços de entrega é uma próxima etapa essencial depois que um endereço é determinado. Com essas informações, é possível:
- Melhorar a produtividade dos motoristas: garanta que eles 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 de combustível para 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 onde quer que você expanda sua empresa.
Os serviços de mobilidade do Google podem ser usados para obter vários dados contextuais 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 contexto adicional aos motoristas no seu aplicativo.
- 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 dos EUA para endereços nos EUA.
- A API Place Details fornece informações sobre pontos de interesse, incluindo o horário de funcionamento das empresas.