Visão geral da API Address Validation

Visão geral da validação de endereç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 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:

  1. 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 endereço inserido pelo cliente.

  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: 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 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 confirmar o endereço conforme determinado pela API.

    • Peça para o cliente adicionar as informações que estão faltando:
      Solicitar que o cliente insira informações de endereço ausentes.

    • 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:
      Peça para o cliente corrigir 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 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:

  • 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 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


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