Visão geral da API Address Validation

Introdução

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 para correspondência e encontra as coordenadas de latitude/longitude mais conhecidas para ele. Se quiser, para endereços nos Estados Unidos e em Porto Rico, ative o Coding Accuracy Support System (CASS™).

Por que usar a API Address Validation

Com a API Address Validation, é possível melhorar a previsibilidade da entrega e reduzir falhas, oferecendo uma experiência melhor para o cliente. Isso é feito ao detectar endereços inválidos e ter uma melhor compreensão das características do endereço.

A API Geocoding pode ser mais adequada às 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 a correção dos endereços. Consulte Como criar recursos de validação de local usando a Plataforma Google Maps na Central 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, é possível 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 errados que você pode apresentar aos clientes para correção. Confira um exemplo de fluxo de trabalho usando a API:

1. 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 da 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 determinado por ela ou indica onde faltam informações.

4. O cliente confirma ou corrige o endereço: dependendo do que a API retorna, você pode fornecer os seguintes comandos 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 na forma de um corpo JSON. Ele separa o endereço em componentes individuais e tenta o seguinte:

• Corrige: oferece verificações de validação no nível do componente, incluindo subunidades quando disponíveis.
• Conclusões: tenta inferir componentes de endereço ausentes ou incorretos.
• Formatos: limpa e padroniza o formato dos componentes de 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 de 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 de 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	Teste 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	Consulte os detalhes da cobertura para saber quais países e regiões a API Address Validation oferece suporte.
3	Começar a configurar	Comece com Configurar seu projeto do Google Cloud e siga as instruções abaixo.
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 usada de maneiras diferentes. Consulte Entender uma resposta básica.
6	Melhorar a precisão da validação	Você pode ajudar a melhorar a acurácia dos endereços 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 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 certificado pelo CASS™, como a API Address Validation, foi confirmado por sua capacidade de preencher informações ausentes de 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ó é compatível 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 os Correios dos EUA identificarem um endereço de entrada como criado artificialmente, o Google será obrigado a parar de validar endereços para o cliente e informar as informações de contato dele (nome e endereço), o endereço de entrada relevante e os dados de uso agregados aos Correios dos EUA. Ao usar a API, você concorda com estes Termos específicos do serviço.

A seguir

• Teste a demonstração: acesse Demonstração
• Analise as áreas de cobertura: acesse Detalhes da cobertura por país e região.
• Tente 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