Este documento aborda a validação de endereço específica nos Estados Unidos:
- Como usar os dados do USPS no seu fluxo de trabalho
- Campos Verificação de pontos de entrega do USPS (dpv)
- Mensagens de segurança
Dados do USPS no seu fluxo de trabalho
Ao validar endereços nos Estados Unidos, o serviço da API Address Validation também pode preencher a parte uspsData do retorno.
Como esse objeto nem sempre é preenchido, não confie nessa propriedade como o único meio de validar endereços. Em vez disso, incorpore os componentes de veredito e endereço ao seu sistema.
Verificação de pontos de entrega (DPV, na sigla em inglês) do USPS
Como parte da resposta uspsData
, o campo dpvConfirmation
retorna um único
para informar se o USPS pode fazer entregas no endereço fornecido.
Use esse campo para determinar o seguinte:
- validade do endereço.
- se um número de subpredial estiver ausente no endereço.
- se o número do sublocal não existir no sistema de dados da USPS.
O serviço retorna um dos quatro valores dpvConfirmation
ou não
retorna um valor dpvConfirmation
. A tabela abaixo mostra o comportamento
recomendado que sua lógica precisa usar para cada um dos cinco resultados possíveis. Para mais
detalhes sobre essa lógica, consulte
Visão geral do fluxo de trabalho em Usar a resposta de validação.
Valor |
Comportamento |
Descrição |
---|---|---|
N ou vazio |
Corrigir o endereço |
O endereço não foi confirmado por DPV. Isso significa que o USPS não reconhece o número da propriedade informado na rua (estrada) informada e não pode fazer a entrega. |
D |
Corrigir o endereço |
O endereço foi confirmado pelo DPV apenas para o número principal, e as informações do número secundário estavam ausentes. |
S |
Confirmar o endereço |
O endereço foi confirmado por DPV apenas para o número principal, e as informações do número secundário estavam presentes, mas não confirmadas. Isso significa que o número da instalação informado existe na rota inserida, mas a subinstalação fornecida não existe nesse edifício, de acordo com o USPS. |
S |
Aceitar o endereço |
O endereço foi confirmado por DPV para números principais e secundários. Isso significa que o endereço pode ser entregue pelo USPS, incluindo o número da sublocalidade, se for o caso. |
O restante desta seção discute cenários reais que usam os códigos DPV.
Exemplo de DPV N: corrigir o endereço
Este exemplo usa um número de rua inexistente em um endereço válido.
- Endereço inserido: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- Região: USA
- O campo
dpvConfirmation
retorna:N
Esse é um indicativo extremamente forte de que esse número de local não existe nessa rota. Assim como em outros endereços problemáticos, seu sistema precisa solicitar correções ao usuário.
Exemplo de DPV: corrigir o endereço
Este exemplo usa o escritório do Google em Nova York, mas não contém um que é uma parte obrigatória do endereço. Para conferir isso, use o endereço na demonstração sem informações de subpredial.
- Endereço inserido: 111 8th Avenue, Nova York, NY, 10011
- Região: EUA
- O campo
dpvConfirmation
retorna:D
Isso confirma que a subpremissa não foi encontrada na entrada. Para chegar a um DPV
de Y, uma sub-presunção válida precisa ser incluída como parte da entrada. Por exemplo,
é possível incluir uma sub-pressuposto válido de FL 4 (4º andar) para receber um
valor dpvConfirmation
de Y.
Exemplo de DPV S: confirmar o endereço
Este exemplo usa um número de subpredial que não existe no edifício:
- Endereço informado: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- Região: EUA
- O campo
dpvConfirmation
retorna:S
Isso indica que, embora 1600 Amphitheatre Parkway exista como um endereço pode aceitar e-mails, a sublocalidade Ste 101 não é uma parte válida do endereço. Seu sistema deve confirmar essas informações com o usuário e fornecer uma para uma correção.
Exemplo de DPV Y: aceitar o endereço
Este exemplo usa o endereço do Googleplex em Mountain View, CA, como um endereço de qualidade conhecida.
- Endereço informado: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- Região: EUA
- O campo
dpvConfirmation
retorna:Y
O endereço pode ser entregue pelo USPS. Isso dá a você um alto nível de confiança de que a API retornou um endereço de boa qualidade, e você pode usá-lo conforme fornecido.
Observação: o DPV não indica se a API Address Validation fez mudanças na entrada, como uma correção ortográfica.
Mensagens de segurança para endereços dos EUA
Esta seção aborda as sinalizações de segurança fornecidas nos dados do USPS para e endereços criados de forma artificial. Essa medida de segurança foi criada para impedir a criação artificial de uma lista de endereços, detectando quando um endereço enviado parece ter sido criado artificialmente e não recebido de forma legítima. Isso deve ser uma ocorrência muito rara.
Quando o USPS identifica um endereço criado artificialmente, o campo errorMessage
da propriedade uspsData da resposta contém uma mensagem de erro que descreve o problema. Exemplo:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.