Visão geral da API Address Validation

A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida componentes de endereço. Ele também padroniza o endereço de correspondência e encontra as coordenadas de latitude/longitude mais conhecidas para ele. Opcionalmente, para endereços nos Estados Unidos e em Porto Rico, é possível ativar o Coding Precisão Support System (CASSTM).

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:

1. 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.
   

2. O app envia o endereço para a API: o aplicativo transmite esse endereço como a entrada para a API Address Validation.

3. 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.

4. 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: Geocodificação Precisão de endereço Dados de serviços postais, quando disponíveis. 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®)¹ 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.