O recurso de captura e validação de endereço é 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 incorreta dos 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 os usuários finais e fornece informações sobre pontos de interesse que podem ser usados para roteamento.
- API Address Validation: determina se um endereço se refere a um local real e oferece outros metadados 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 dependentes. Se você receber endereços por um aplicativo voltado ao usuário ou de parceiros upstream usando uma API, os serviços de mobilidade do Google poderão ajudar nessa etapa.
Se você receber 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 com a captura de endereços da seguinte maneira:
Melhorar a experiência do consumidor:ofereça aos usuários as ferramentas para garantir que eles possam fornecer 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 repetir as 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 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 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, eles podem fornecer um endereço digitando apenas alguns caracteres e selecionando 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 aos locais atendidos pela sua empresa.
Validar o endereço
Depois de capturar um endereço, seja pela entrada direta do usuário ou usando uma API, verifique se o cliente forneceu um endereço correto. Isso significa um endereço livre de imprecisões, como componentes ausentes ou erros de digitação. A validação de endereço ajuda a reduzir falhas de entrega detectando endereços incorretos e melhorando a previsibilidade de entrega com maior 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. 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 incorretos, 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 para o usuário corrigir o problema. Se você receber o endereço usando 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ê validar o endereço, use a Plataforma Google Maps para fornecer um mapa e um marcador para indicar o local 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 podem ser usados para encontrar partes de endereço 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 capturar 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ê tenha configurado um projeto no Console de APIs do Google e ativado as contas de serviço e o faturamento corretos. Para detalhes específicos sobre os serviços de mobilidade do Google, consulte a documentação do Fleet Engine para configurar seu projeto.
Ativar os 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 você pode usar, como a seção Parâmetros opcionais. 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 local, como endereços e até mesmo idiomas de entrada permitidos pelo usuário.
- Para uma implantação simplificada de um formulário de endereço, a Plataforma Google Maps oferece um Criador rápido de soluções no Google API Console.
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 preferidas para dispositivos móveis e Web. Para detalhes, consulte a documentação da API Maps JavaScript e navegue até outras instruções da plataforma.
- Obtenha o código de geolocalização do endereço na API Address Validation ou transmitindo o ID do lugar do Place Autocomplete para a API Geocoding, e adicione um marcador ao local.
- Para permitir que o usuário ajuste as coordenadas de entrega, torne os marcadores deslizantes. Consulte a documentação sobre os comportamentos dos marcadores (Android, iOS e Web).
- Extraia o geocódigo da posição do marcador ajustada. Também é possível transmitir o geocódigo atualizado para a API Geocoding reversa para recuperar o endereço correspondente. Em seguida, é possível avaliar os componentes do 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 os motoristas tenham todas as informações necessárias para concluir as entregas com sucesso e eficiência. Quando combinados com outros recursos dos Serviços de Mobilidade do Google, você pode garantir que os motoristas cheguem ao lugar certo na hora certa.
- Reduzir custos: levar o motorista ao lugar certo de forma eficiente e reduzir as entregas repetidas também pode reduzir os custos de mão de obra e de combustível da sua frota.
- Escalar suas operações: todos os recursos de captura de endereços usam o banco de dados geoespacial global do Google, que oferece cobertura granular sempre que você expandir sua empresa.
Os serviços de Mobilidade do Google podem ser usados para receber 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 sistemas de otimização de rotas ou para fornecer mais contexto aos motoristas no app para motoristas.
- 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 indicadores de validação, a API Address Validation também fornece a latitude/longitude do endereço de entrada. Ele também fornece sinalizações residenciais e comerciais para o local e uma variedade de dados dos Correios para endereços nos EUA.
- A API Place Details fornece informações sobre pontos de interesse, incluindo o horário de funcionamento da empresa.