Por que usar a API Address Validation
Com a API Address Validation, é possível melhorar a previsibilidade de entrega e reduzir as falhas na entrega, melhorando a experiência do cliente. Você faz isso detectando endereços incorretos e entendendo melhor as características do endereço.
A API Geocoding pode ser uma opção melhor 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/longitude, enquanto a API Address Validation valida os endereços quanto à precisão. Consulte Como criar um recurso de validação de local usando a Plataforma Google Maps no Centro de arquitetura para ver 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ê pode apresentar aos seus clientes para corrigir. Este é um exemplo de fluxo de trabalho que usa a API:
O cliente insere um endereço: a imagem a seguir mostra um formulário simples que permite que o 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 a entrada para a API Address Validation.
A API valida e padroniza o endereço: em sua resposta, a API Address Validation retorna o endereço completo conforme determinado pela API ou indica onde estão faltando informações.
O cliente corrige ou confirma o endereço recomendado: dependendo do que a API retorna, você pode dar as seguintes instruções:
Apresente um endereço recomendado para o cliente confirmar:
Peça para o cliente adicionar as informações que estão faltando:
Solicite que o usuário corrija 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 na forma de um corpo JSON. Ele separa o endereço nos componentes individuais e faz as seguintes verificações e correções:
- Correto: fornece verificações de validação no nível do componente, incluindo sublocais, quando disponíveis.
- Concluído: tentativas de inferir componentes de endereço ausentes ou incorretos.
- Bem formatado: limpa e padroniza o formato dos componentes de 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 pela API Address Validation com os dados retornados. Para detalhes específicos, consulte a referência da API Address Validation.
| Recursos de dados | Dados retornados |
|---|---|
|
Gerencie os componentes 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 | Veja a demonstração | Explore a demonstração com vários formulários de endereço, corretos e incorretos. A demonstração oferece uma maneira útil de explorar tanto os valores de retorno do serviço quanto a resposta da API formatada em JSON. |
| 2 | Conferir a cobertura | Consulte os detalhes da cobertura para saber quais países e regiões são aceitos pela API Address Validation. |
| 3 | Configuração | Comece em Configurar seu projeto do Google Cloud e siga as instruções a seguir. |
| 4 | Solicitar uma validação de endereço | Comece com um endereço simples e, em seguida, para maior precisão, ative o CASS (somente para endereços dos EUA e PR). Consulte Solicitar uma validação de endereço. |
| 5 | Processar uma resposta | A resposta da API Address Validation fornece duas propriedades, cada uma usada de maneiras diferentes. Consulte Noções básicas sobre 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 uma lista das bibliotecas de cliente disponíveis para a API Address Validation, consulte Bibliotecas de cliente.
Sobre o CASSTM
O United States Postal Service® (USPS®)1 mantém o Coding Precisão Support System (CASSTM) para dar suporte e certificar os provedores de validação de endereço. Um serviço CASS CertifiedTM, como a API Address Validation, foi confirmado devido à capacidade de preencher, padronizar e atualizar as informações ausentes de um endereço para fornecer o endereço mais atual e preciso.
O CASS não está 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 nosso uso dos serviços da USPS, a USPS avalia solicitações de endereços criados artificialmente. Se o USPS identificar que um endereço de entrada foi criado artificialmente, o Google precisará interromper a validação dos endereços do cliente e informar ao USPS os dados de contato dele (nome e endereço), o endereço de entrada relevante e os dados de uso agregados. Ao usar a API, você concorda com estes Termos de serviço específicos.
A seguir
- Analise as perguntas frequentes: acesse as Perguntas frequentes.
- Revisar as áreas de cobertura: acesse Detalhes de cobertura por país e região.
- Processar endereços em grande volume: acesse Usar a API Address Validation para processar muitos endereços.
-
A Plataforma Google Maps é uma licenciada não exclusiva do Serviço Postal dos Estados Unidos®. As marcas registradas a seguir são do Serviço Postal dos Estados Unidos® e usadas com permissão: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩