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

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

Se o endereço de faturamento estiver no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE vão se aplicar ao uso dos Serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Todos os itens em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

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 os componentes do endereço. Ele também padroniza o endereço para envio por correio 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™).

Com a API Address Validation, você pode melhorar a previsibilidade da entrega e reduzir os erros de envio, melhorando a experiência do cliente. Para isso, você detecta endereços inválidos e fica mais consciente 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 endereços para verificar se eles estão corretos. 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 é possível 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 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 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 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:

   1. Confirme o endereço recomendado.
   2. Forneça as informações que estão faltando.
   3. Corrija o endereço.
   

Como a validação de endereço funciona na API Maps JavaScript

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

• Corretos: oferece verificações de validação no nível do componente, incluindo subpremissas, quando disponíveis.
• Concluídos: tenta inferir componentes de endereço ausentes ou incorretos.
• Formatos: limpa e padroniza o formato dos componentes do endereço.

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 por 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 da USPS, ela avalia solicitações de endereços criados artificialmente. Se o USPS identificar que um endereço de entrada foi criado artificialmente, o Google vai precisar parar de validar 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.

Próximas etapas

• Começar a usar a validação de endereço na API Maps JavaScript

---

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