Visão geral da API Address Validation

A API Address Validation é um serviço que aceita um endereço. Ele identifica e valida os componentes do endereço. Ele também padroniza o endereço de correspondência e encontra as coordenadas de latitude/longitude mais conhecidas. Opcionalmente, para endereços nos Estados Unidos e em Porto Rico, você pode ativar o Coding Accuracy Support System (CASS™).

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

inputTeste a demonstração

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:

1. O cliente insere um endereço: a imagem a seguir mostra um formulário básico 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 entrada para a API Address Validation.

   

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

4. O cliente confirma ou corrige o endereço: dependendo do que a API retornar, você pode fornecer as seguintes solicitações ao cliente: A. Confirme o endereço recomendado. B. Forneça as informações que estão faltando. C. Corrija o endereço.

   

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 tenta o seguinte:

• Corretos: oferece verificações de validação no nível do componente, incluindo subpremissas, quando disponíveis.
• Conclui: tenta inferir componentes de endereço ausentes ou incorretos.
• Formatos: limpa e padroniza o formato dos componentes do endereç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: Geocódigo Precisão do endereço Dados de serviços postais, quando disponíveis. 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 (somente 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®)¹ 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

• Teste a demonstração: acesse Demonstração.
• Revisar as áreas de cobertura: acesse Detalhes da cobertura de países e regiões.
• Tente fazer sua primeira solicitação de validação: acesse Enviar uma solicitação de validação de endereço.
• Processar endereços em grande volume: acesse Usar a API Address Validation para processar endereços em grande volume.