A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida os componentes de endereço. Ele também padroniza o endereço de correspondência e encontra as coordenadas de latitude/longitude mais conhecidas dele. Para endereços nos Estados Unidos e em Porto Rico, é possível ativar o Coding Accuracy Support System (CASSTM).
Por que usar a API Address Validation
Com a API Address Validation, é possível melhorar a previsibilidade e reduzir as falhas de entrega, proporcionando uma experiência melhor ao cliente. Para fazer isso, identifique endereços incorretos e saiba quais são as características deles.
A API Geocoding pode ser uma opção melhor se você não precisar validar os componentes de endereço individuais. A API Geocoding converte endereços em coordenadas de latitude/longitude, e a API Address Validation valida a precisão dos endereços. Consulte Como criar o 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 local real, a API poderá identificar componentes possivelmente errados que você pode apresentar aos seus clientes para corrigir. Confira 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 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 retorna, é possível apresentar as seguintes solicitações ao cliente:
Apresente um endereço recomendado para o cliente confirmar:
Peça para o cliente adicionar as informações que estão faltando:
Peça 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, em seguida, 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: tenta inferir componentes de endereço ausentes ou incorretos.
- Bem formatado: limpa e padroniza o formato dos componentes de endereço.
Experimente a demonstração para ver a API Address Validation em ação.
Recursos
A tabela a seguir resume os recursos disponíveis por meio da API Address Validation com os dados retornados. Para detalhes específicos, consulte a referência da API Address Validation.
Recursos de dados | Dados retornados |
---|---|
Abordar 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 | Experimente a demonstração | Explore a demonstração com várias formas de endereço, corretas e incorretas. A demonstração é uma maneira útil de explorar os valores de retorno do serviço e a resposta da API formatada em JSON. |
2 | Conferir a cobertura | Consulte os detalhes da cobertura para saber com quais países e regiões a API Address Validation oferece suporte. |
3 | Configuração | Comece por 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, para aumentar a 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 | Ajude a melhorar a precisão do endereço fornecendo feedback sobre as respostas da API Address Validation. Consulte Processar endereços atualizados. |
Bibliotecas de clientes disponíveis
Para ver 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 Accuracy Support System (CASSTM) para dar 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 em um endereço, padronizá-las e atualizá-las 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 do USPS, o 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 para o cliente e 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
- Analisar as perguntas frequentes: acesse as Perguntas frequentes.
- Analisar á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 registradas a seguir são do Serviço Postal dos Estados Unidos® e usadas com permissão: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩