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

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

Por que usar a API Address Validation na API Maps JavaScript?

A biblioteca Address Validation usa um endereço como entrada para identificar e validar 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™).

Com a API Address Validation, é possível melhorar a previsibilidade da entrega e reduzir falhas, oferecendo uma experiência aprimorada ao cliente. Para isso, capture endereços inválidos e tenha mais consciência das características deles.

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

Com a API 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 que um cliente insira 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 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 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:

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

Como funciona a validação de endereço 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 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.

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 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" em 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 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 precisará informar os dados 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 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™. ↩