Por que usar a API Address Validation
Com a API Address Validation, você pode melhorar a previsibilidade de envio e reduzir erros de entrega, melhorando a experiência do cliente. Para fazer isso, detecte endereços inválidos e tenha mais consciência das características dos endereços.
A API Geocoding pode ser mais adequada para suas necessidades se você não precisar validar os componentes de endereço individuais. A API Geocoding converte endereços em coordenadas de latitude e longitude. A API Address Validation valida endereços para correção. Consulte Como criar um recurso de validação de local usando a Plataforma Google Maps no Centro de arquitetura para uma comparação detalhada.
O que você pode fazer com a API Address Validation
Com a API Address Validation, você pode determinar se um endereço se refere a um lugar real. Se o endereço não se referir a um lugar real, a API poderá identificar componentes possivelmente incorretos que você poderá apresentar aos clientes para correção. Confira um exemplo de fluxo de trabalho que usa a API:
O cliente insere um endereço: a imagem a seguir mostra um formulário básico que permite que um cliente insira um endereço, possivelmente como parte de um fluxo de finalização de compra.
O app envia o endereço para a API: o aplicativo transmite esse endereço como entrada para a API Address Validation.
A API valida e padroniza o endereço: na resposta, a API Address Validation retorna o endereço completo conforme determinado pela API ou indica onde há informações ausentes.
O cliente corrige ou confirma o endereço recomendado: dependendo do que a API retornar, você pode fornecer as seguintes solicitações ao cliente:
Apresente um endereço recomendado para o cliente confirmar:
Peça ao cliente para adicionar as informações ausentes:
Peça ao usuário para corrigir o endereço se a API não conseguir validar o endereço de entrada devido a informações ausentes ou incorretas:
Como a API Address Validation funciona
A validação de endereço aceita uma solicitação POST com o endereço no formato de um corpo JSON. Ele separa o endereço nos componentes individuais e faz as seguintes verificações e correções:
- Correto: oferece verificações de validação no nível do componente, incluindo subpremissas, quando disponíveis.
- Completo: tenta inferir componentes de endereço ausentes ou incorretos.
- Formato adequado: limpa e padroniza o formato dos componentes do endereço.
Teste a demonstração para conferir a API Address Validation em ação.
Recursos
A tabela a seguir resume os recursos disponíveis na API Address Validation e os dados que ela retorna. Para detalhes específicos, consulte a referência da API Address Validation.
| Recursos de dados | Dados retornados |
|---|---|
|
Componentes do 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 do endereço. Quando disponível para um endereço:
Consulte Entender a resposta de validação. |
Como usar a API Address Validation
| 1 | Testar a demonstração | Confira a demonstração com vários formulários de endereço, corretos e incorretos. A demonstração oferece uma maneira útil de explorar os valores de retorno do serviço, bem como a resposta da API formatada em JSON. |
| 2 | Verificar a cobertura | Confira os detalhes da cobertura para saber quais países e regiões são compatíveis com a API Address Validation. |
| 3 | Configurar | Comece com Configurar seu projeto do Google Cloud e siga as instruções. |
| 4 | Solicitar uma validação de endereço | Comece com um endereço básico e, para mais precisão, ative o CASS (apenas para endereços dos EUA e de Porto Rico). Consulte Solicitar uma validação de endereço. |
| 5 | Processar uma resposta | A resposta da API Address Validation fornece duas propriedades, cada uma delas é usada de maneiras diferentes. Consulte Entender uma resposta básica. |
| 6 | Melhorar a precisão da validação | Você pode ajudar a melhorar a precisão do endereço enviando feedback sobre as respostas da API Address Validation. Consulte Processar endereços atualizados. |
Bibliotecas de clientes disponíveis
Para conferir uma lista das bibliotecas de cliente disponíveis para a API Address Validation, consulte Bibliotecas de cliente.
Sobre o CASS™
O United States Postal Service® (USPS®)1 mantém o Coding Accuracy Support System (CASS™) para auxiliar e certificar os provedores de validação de endereço. Um serviço CASS Certified™, como a API Address Validation, foi confirmado pela capacidade de preencher informações ausentes em um endereço, padronizá-lo e atualizá-lo para fornecer o endereço mais atual e preciso.
O CASS não é ativado por padrão e só tem suporte para 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 do USPS, ele avalia solicitações de endereços criados artificialmente. Se o USPS identificar que um endereço de entrada foi criado artificialmente, o Google será obrigado a parar de validar endereços para o cliente e vai precisar informar os dados de contato do cliente (nome e endereço), o endereço de entrada relevante e os dados de uso agregados ao USPS. Ao usar a API, você concorda com estes Termos Específicos do Serviço.
A seguir
- Consulte as perguntas frequentes: acesse as Perguntas frequentes.
- Revisar as á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 grande volume.
-
A Plataforma Google Maps é uma licenciada não exclusiva do Serviço Postal dos Estados Unidos®. As marcas comerciais a seguir são do Serviço Postal dos Estados Unidos® e usadas com permissão: United States Postal Service®, CASS™, CASS Certified™. ↩