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.
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:
Se a API Address Validation detectar informações ausentes, solicite que o usuário a adicione:
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:
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
- Experimente a demonstração
- Perguntas frequentes
- Detalhes da cobertura de país e região
- Configuração no Console do Cloud
- Gerar uma chave de API
- Bibliotecas de clientes
-
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. ━