Aceitar endereço: exemplos

Este documento descreve vários cenários do mundo real em que A API Address Validation fornece sinais de resposta que justificam um comportamento de aceitação. do seu sistema. Consulte Visão geral do fluxo de trabalho na Use a resposta de validação para contexto.

Exemplo comum: aceitar

Este cenário ilustra um endereço no qual seu sistema aceitaria uma e o endereço de e-mail inserido por um cliente.

Endereço inserido Região
76 Buckingham Palace Road, Londres SW1W 9TQ Reino Unido

Veredito de um endereço aceitável

O exemplo abaixo destaca os indicadores importantes.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Além disso, a resposta indica o seguinte:

  • hasUnconfirmedComponents continua sendo false
  • hasInferredComponents continua sendo false
  • hasReplacedComponents continua sendo false

Quando combinados, esses sinais indicam um endereço de alta qualidade.

Exemplos de casos extremos: aceitar

Os exemplos a seguir abrangem situações em que verdict indica o endereço problemas de qualidade que exigem uma investigação mais aprofundada. Esses exemplos também ilustrar como a lógica pode passar do veredito até os componentes de endereço para ter uma visão mais completa e aprimorar a lógica do seu sistema.

Número não confirmado do endereço fora dos EUA

Este exemplo ilustra a entrada de um endereço italiano com todos os componentes de endereço e nenhum componente inferido ou substituído. No entanto, validationGranularity é ROUTE.

Endereço inserido Região
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Itália IT

Veredito de um número de rua não confirmado

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Uma investigação mais aprofundada dos componentes do endereço revela que a rua número é UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Número da rua não confirmado nos EUA

Este exemplo ilustra a entrada de um endereço nos EUA com todos os componentes de endereço sem componentes inferidos ou substituídos. No entanto, validationGranularity é PREMISE_PROXIMITY.

Endereço inserido Região
975 Carson Dr, Sunnyvale, CA 94086 – EUA EUA

Dados do USPS para um número de rua não confirmado

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Dados do USPS incompletos para um endereço confirmado

Este exemplo ilustra a entrada de um endereço nos EUA com todos os componentes de endereço confirmados, sem componentes inferidos ou substituídos, e um validationGranularity de PREMISE. No entanto, o uspsData não é totalmente preenchido e não contém um valor de dpvConfirmation.

Endereço inserido Região
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 EUA

Veredito de um endereço confirmado com dados da USPS incompletos

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

Dados do USPS para um endereço confirmado com dados do USPS incompletos

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}
.