Akceptowanie adresu – przykłady

W tym dokumencie opisujemy kilka rzeczywistych sytuacji, w których interfejs Address Validation API zwraca sygnały odpowiedzi, które uzasadniają zaakceptowanie przez system. Więcej informacji znajdziesz w sekcji Przykładowe przepływy pracy w artykule Tworzenie logiki weryfikacji.

Typowy przykład: akceptacja

Ten scenariusz ilustruje adres, w przypadku którego system zaakceptuje adres wpisany przez klienta.

Werdykt dotyczący akceptowalnego adresu

W przykładzie poniżej wyróżniono ważne sygnały.

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

Oprócz tego odpowiedź zawiera te informacje:

• hasUnconfirmedComponents pozostaje false
• hasInferredComponents pozostaje false
• hasReplacedComponents pozostaje false
• hasSpellCorrectedComponents pozostaje false

W połączeniu te sygnały wskazują na wysoką jakość adresu.

Przykłady przypadków skrajnych: akceptacja

Poniższe przykłady dotyczą sytuacji, w których verdict wskazuje na problemy z jakością adresu, które wymagają dalszego zbadania. Te przykłady pokazują też, jak logika może przechodzić od werdyktu do komponentów adresu, aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.

Niepotwierdzony numer domu poza Stanami Zjednoczonymi

Ten przykład pokazuje wpisanie adresu we Włoszech ze wszystkimi komponentami adresu i bez komponentów wywnioskowanych lub zastąpionych. Jednak validationGranularity to ROUTE.

Werdykt dotyczący niepotwierdzonego numeru domu

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

Dalsza analiza komponentów adresu wykazała, że numer ulicy to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w USA

Ten przykład ilustruje wpisanie adresu w USA ze wszystkimi komponentami adresu, bez komponentów wywnioskowanych lub zastąpionych. Jednak validationGranularity to PREMISE_PROXIMITY.

Dane USPS dotyczące niepotwierdzonego numeru domu

{
   "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",
}

Niekompletne dane USPS dotyczące potwierdzonego adresu

Ten przykład pokazuje wpisanie adresu w Stanach Zjednoczonych, w którym wszystkie komponenty adresu zostały potwierdzone, nie ma komponentów wywnioskowanych ani zastąpionych, a validationGranularity wynosi PREMISE. Jednak parametr uspsData nie jest w pełni wypełniony i nie zawiera wartości dpvConfirmation.

Werdykt dotyczący potwierdzonego adresu z niekompletnymi danymi USPS

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

Dane USPS dotyczące potwierdzonego adresu z niekompletnymi danymi USPS

{
  "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"
}