Visão geral da API Address Validation

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Address Validation é um serviço que aceita um endereço, identifica e valida os componentes dele. Ele também padroniza o endereço para correspondência e encontra o local de latitude/longitude mais conhecido. Ele pode ajudar a entender se um endereço se refere a um lugar real. Se o endereço não se referir a um lugar real, ele poderá identificar componentes possivelmente errados, permitindo que os usuários os corrijam.

A API Address Validation oferece muitos recursos para processar um endereço, incluindo:

  • Separa o endereço em componentes individuais e, em seguida, fornece verificações de validação no nível do componente, incluindo subpropriedades (quando disponíveis).

  • Limpa, padroniza e infere componentes de endereço ausentes ou incorretos.

  • Complementa o endereço com informações adicionais, incluindo geocódigo, precisão de endereço e dados de serviços postais.

  • Retorna uma única string contendo o endereço completo, conforme determinado pela API.

Experimente a demonstração para ver a API Address Validation em ação.

Adicionar a API Address Validation ao fluxo de trabalho

Um dos casos de uso mais comuns da API Address Validation é melhorar a experiência do cliente, garantindo que ele forneça um endereço correto. A validação de endereço ajuda a reduzir falhas de entrega ao detectar endereços inadequados e melhora a previsibilidade da entrega com melhor reconhecimento das características do endereço.

A imagem a seguir mostra um formulário simples que permite que o cliente insira um endereço, possivelmente como parte de um fluxo de finalização de compra. Transmita esse endereço como a entrada para a API Address Validation.

O endereço inserido pelo cliente.

Na resposta, a API Address Validation retorna o endereço completo conforme determinado pela API. Apresente o endereço completo para o cliente como recomendado:

O endereço, conforme determinado pela API.

Se a API Address Validation detectar informações ausentes, solicite que o usuário a adicione:

O formulário que solicita que o cliente digite as informações do endereço ausentes.

Se a API não conseguir validar o endereço de entrada devido a informações ausentes ou incorretas, peça ao usuário para corrigir o endereço:

O formulário que solicita ao cliente que corrija as informações de endereço.

Diferenças entre a API Address Validation e a API Geocoding

Tanto a API Geocoding quanto a API Address Validation tentam responder à pergunta "qual é o melhor local para essa entrada do usuário?" Ao contrário da API Geocoding, a API de validação de endereço também tenta:

  • Responda à pergunta "Essa entrada do usuário representa um endereço real?"
  • Entender o endereço de entrada, mesmo que não seja possível corresponder partes dele aos dados disponíveis
  • Dar feedback sobre a validade de diferentes componentes
  • Verifique se o endereço está completo e sinalize todos os componentes necessários que estão faltando
  • Formatar o endereço retornado especificamente para fins de correspondência

Por exemplo, considerando um endereço como "Rua Fake, 123, Mountain View, CA", a API Geocoding retornará um código geográfico para a cidade de Mountain View, CA. Depois, ignoraria "Rua Fake Street, 123", já que não há essa rua (ou rua com nome semelhante) em Mountain View.

A API Address Validation, por outro lado, consegue identificar que "123" é um número de rua, "Fake St" é uma rua e retorna um resultado que contém esses componentes e os sinaliza como não confirmado, um sinal sobre o motivo da falha na geocodificação do endereço.

Sobre o CASSTM

O Serviço postal dos Estados Unidos (USPS®, na sigla em inglês)1 mantém o Sistema de suporte de precisão de codificação (CASSTM, na sigla em inglês) para oferecer 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 de um endereço, padronizá-lo e atualizá-lo 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 uso dos serviços de USPS, a USPS avalia as solicitações de endereços criados artificialmente. Se a USPS identificar um endereço de entrada como sendo criado de forma artificial, o Google precisará parar de validar os endereços do cliente e precisa informar os dados de contato do cliente (nome e endereço), o endereço de entrada relevante e os dados de uso agregados para o USPS. Ao usar a API, você concorda com estes Termos específicos de serviço.

A seguir


  1. A Plataforma Google Maps é um licenciado não exclusivo do serviço postal dos Estados Unidos. As marcas registradas a seguir são de propriedade do serviço postal dos Estados Unidos e são usadas com permissão: CASTM, CASSTM e CASS Certified.