Processar endereços dos Estados Unidos

Este documento aborda a validação de endereço específica nos Estados Unidos:

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 conte com este como o único meio de validar endereços, mas incorporar o veredito e abordar componentes no 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 faltar um número de sublocal 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 retornam um valor dpvConfirmation. A tabela abaixo mostra comportamento que sua lógica deve 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 do local inserido. existente na rua inserida (trajeto) e não pode fazer entregas nela.

D

Corrigir o endereço

O endereço foi confirmado por DPV somente para o número principal, e o faltavam informações do número secundário.

Isso significa que a premissa número inserido existe na rua inserida, mas para chegar a um número endereço verificado/entrega, um número de sublocal válido também precisa ser fornecidas. Em outras palavras, a subpremissa não estava na entrada.

S

Confirmar o endereço

O endereço foi confirmado por DPV somente para o número principal, e o as informações do número secundário estavam presentes, mas não foram confirmadas.

Isso significa que o número do local inserido existe no trajeto inserido, mas a subpremissa fornecida não existe nesse edifício, segundo à 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 do mundo real que usam 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 informado: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Região: USA
  • O campo dpvConfirmation retorna: N

Isso é um indicador extremamente forte de que esse número de premissa não existe. nesse trajeto. Assim como em outros endereços problemáticos, seu sistema deve solicitar o usuário para correções.

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. Você pode verificar isso usando o endereço na demonstração sem informações de sublocais.

  • Endereço inserido: 111 8th Avenue, Nova York, NY, 10011
  • Região: USA
  • O campo dpvConfirmation retorna: D

Isso confirma que a subpremissa não foi encontrada na entrada. Para chegar a um DPV de Y, um sublocal válido precisa ser incluído como parte da entrada. Por exemplo: é possível incluir um sublocal válido de FL 4 (4o andar) para conseguir uma dpvConfirmation é o valor de Y.

Exemplo de DPV S: confirmar o endereço

Este exemplo usa um número de sublocal que não existe no edifício:

  • Endereço informado: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Região: USA
  • 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: USA
  • O campo dpvConfirmation retorna: Y

O endereço pode ser entregue pela USPS. Isso oferece um alto grau de a 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 realizou 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 Criação artificial de uma lista de endereços detectando quando um endereço enviado pareça ter sido construída artificialmente e não obtida de maneira legítima. Isso deve ser uma ocorrência muito rara.

Quando o USPS identifica um endereço criado artificialmente, o 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.