Visão geral da validação de endereço

Desenvolvedores do Espaço Econômico Europeu (EEE)

Por que usar a Address Validation na API Maps JavaScript?

A biblioteca Address Validation usa um endereço como entrada para identificar e validar os componentes dele. Ele também padroniza o endereço para correspondência e encontra as coordenadas de latitude/longitude mais conhecidas para ele. Como opção, para endereços nos Estados Unidos e em Porto Rico, é possível ativar o Coding Accuracy Support System (CASS™).

Com a API Address Validation, você pode melhorar a previsibilidade de entrega e reduzir as falhas de entrega, proporcionando uma melhor experiência do cliente. Para isso, identifique endereços incorretos e entenda melhor as características deles.

O que você pode fazer com a Address Validation na API Maps JavaScript

Com a Address Validation na API Maps JavaScript, 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 errados que você pode apresentar aos clientes para correção. Confira um exemplo de fluxo de trabalho:

  1. O cliente insere um endereço: a imagem a seguir mostra um formulário básico que permite ao cliente inserir um endereço, possivelmente como parte de um processo 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 usando o método fetchAddressValidation.

  3. A API valida e padroniza o endereço: na resposta, a API Address Validation retorna o endereço completo, conforme determinado por ela, ou indica onde estão faltando informações.

  4. O cliente confirma ou corrige o endereço: dependendo do que a API retorna, você pode fornecer as seguintes solicitações ao cliente:

    1. Confirme o endereço recomendado.
    2. Forneça as informações que faltam.
    3. Corrija o endereço.
    O cliente pode confirmar o endereço corrigido. O cliente pode fornecer as informações que faltam. O cliente pode corrigir o endereço.

Como funciona o Address Validation na API Maps JavaScript

Quando uma chamada para fetchAddressValidation é feita, a API tenta o seguinte:

  • Correções: fornece verificações de validação no nível do componente, incluindo subinstalações, quando disponíveis.
  • Completa: tenta inferir componentes de endereço ausentes ou incorretos.
  • Formata: limpa e padroniza o formato dos componentes do endereço.

Sobre o CASS™

O United States Postal Service® (USPS®)1 mantém o Coding Accuracy Support System (CASS™) para auxiliar e certificar os provedores de validação de endereço. Um serviço com certificação CASS Certified™, como a API Address Validation, foi confirmado pela 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 o USPS identificar que um endereço de entrada foi criado artificialmente, o Google será obrigado a interromper a validação de 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 de Serviço.

Próximas etapas

  1. A Plataforma Google Maps é uma licenciada não exclusiva do United States Postal Service®. As marcas comerciais a seguir são do United States Postal Service® e usadas com permissão: United States Postal Service®, CASS™, CASS Certified™. ↩