Por que usar a API Address Validation
Com a API Address Validation, é possível melhorar a previsibilidade de entrega e reduzir as falhas de entrega, melhorando a experiência do cliente. Isso é feito capturando endereços inválidos e reconhecendo melhor as características dos endereços.
Se você não precisa validar os componentes de endereço individuais para sua solicitação, a API Geocoding pode ser uma correspondência melhor para suas necessidades. A API Geocoding converte endereços em coordenadas de latitude/longitude, enquanto a API Address Validation valida a precisão dos endereços. Para detalhes, consulte Como a API Address Validation funciona abaixo, bem como a Visão geral da API Geocoding.
O que você pode fazer com a API Address Validation
Com a API Address Validation, é possível determinar se um endereço se refere a um lugar real. Se o endereço não se referir a um local real, a API poderá identificar componentes possivelmente errados que você pode apresentar aos clientes para corrigir. Veja um exemplo de fluxo de trabalho usando a API:
O cliente insere um endereço: a imagem a seguir mostra um formulário simples que permite ao cliente inserir um endereço, possivelmente como parte de um fluxo de finalização da compra.
O app envia o endereço para a API: o aplicativo transmite esse endereço como a entrada para a API Address Validation.
A API valida e padroniza o endereço: na resposta, a API de validação de endereço retorna o endereço completo conforme determinado pela API ou indica onde estão as informações ausentes.
O cliente corrige ou confirma o endereço recomendado: dependendo do que a API retorna, você pode fornecer as seguintes solicitações ao cliente:
Apresente um endereço recomendado para o cliente confirmar:
Peça para o cliente adicionar informações ausentes:
Solicite que o usuário corrija o endereço se a API não puder validar o endereço de entrada devido a informações ausentes ou incorretas:
Como funciona a API Address Validation
A validação do endereço aceita uma solicitação POST com o endereço na forma de um corpo JSON. Ele separa o endereço nos componentes individuais e faz as seguintes verificações e correções:
- Fornece verificações de validação no nível do componente, incluindo sub-locais, quando disponíveis.
- Tenta inferir componentes de endereço ausentes ou incorretos.
- Limpa e padroniza o formato dos componentes de endereço.
Teste a demonstração para ver a API Address Validation em ação.
Recursos
Na tabela a seguir, resumimos os recursos disponíveis por meio da API Address Validation e os dados retornados. Para detalhes específicos, consulte a referência da API Address Validation.
| Recursos de dados | Dados retornados |
|---|---|
|
Componentes de endereço no formato JSON. Consulte Validar um endereço. |
Endereço completo e validado (se possível). Status de validação de cada componente de endereço. Quando disponível para um endereço:
Consulte Entenda a resposta da validação. |
Como usar a API Address Validation
| 1 | Teste a demonstração | Explore a demonstração com uma variedade de formulários de endereço, corretos e incorretos. A demonstração fornece uma maneira útil de explorar os valores de retorno do serviço, bem como a resposta da API formatada em JSON. |
| 2 | Prepare-se. | Comece com Configurar seu projeto do Google Cloud e siga as instruções a seguir. |
| 3 | Validar um endereço | Comece com um endereço simples e, para maior precisão, ative o CASS (apenas para endereços dos EUA e PR). Consulte Validar um endereço. |
| 4 | Processar uma resposta | A resposta da API de validação de endereço fornece duas propriedades, cada uma delas usada de maneiras diferentes. Consulte Entenda a resposta da validação. |
| 5 | Melhorar a precisão da validação | Você pode nos ajudar a melhorar a precisão do endereço fornecendo feedback sobre as respostas da API Address Validation. Consulte Enviar feedback de validação de endereço. |
Bibliotecas de clientes disponíveis
Para uma lista das bibliotecas de cliente disponíveis para a API Address Validation, consulte Bibliotecas de cliente.
Sobre o CASSTM
O Serviço Postal dos Estados Unidos1 mantém o Sistema de suporte de precisão de codificação (CASSTM, na sigla em inglês) para oferecer suporte e certificar provedores de validação de endereço. Um serviço CASS CertifiedTM, como a API Address Validation, foi confirmado pela capacidade de preencher informações ausentes de um endereço, padronizá-lo e atualizá-lo para fornecer a você o endereço mais atual e mais preciso.
O CASS não é ativado por padrão e é compatível apenas com as regiões "US" e "PR". Para ativar o CASS, defina enableUspsCass como true como parte de uma solicitação de validação. Para mais informações, consulte Validar um endereço.
Como parte do uso dos serviços da USPS, ela avalia as solicitações de endereços criados artificialmente. Se o USPS identificar um endereço de entrada como sendo criado artificialmente, o Google será obrigado a interromper a validação de endereços para o cliente e precisará informar os dados de contato do cliente (nome e endereço), o endereço de entrada relevante e os dados de uso agregados para o USPS. Ao usar a API, você concorda com estes Termos de serviço específicos.
A seguir
- Consulte as perguntas frequentes: acesse Perguntas frequentes.
- Revisar áreas de cobertura: acesse Detalhes da cobertura por país e região
- Processar endereços em grande volume: acesse Usar a API Address Validation para processar endereços em alto volume
-
A Plataforma Google Maps é um Licenciado não exclusivo do Serviço Postal dos Estados Unidos. As seguintes marcas registradas pertencem ao Serviço Postal dos Estados Unidos e é usada com permissão: CATETM, CASSTM e SSN.