Akceptowanie adresu – przykłady

W tym dokumencie opisujemy kilka rzeczywistych sytuacji, w których interfejs Address Billingation API dostarcza sygnały odpowiedzi, które uzasadniają akceptację działania systemu. Kontekst znajdziesz w sekcji Omówienie przepływu pracy w artykule Używanie odpowiedzi weryfikacji.

Typowy przykład: akceptacja

Ten scenariusz pokazuje adres, pod którym Twój system będzie akceptować adres wpisany przez klienta.

Wpisano adres Region
76 Buckingham Palace Road, London SW1W 9TQ, United Kingdom Wielka Brytania

Ocena dopuszczalnego adresu

Przykład poniżej wskazuje ważne sygnały.

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

Oprócz tego odpowiedź zawiera te informacje:

  • hasUnconfirmedComponents: false
  • hasInferredComponents: false
  • hasReplacedComponents: false

Połączenie tych sygnałów w połączeniu wskazuje na wysoką jakość adresu.

Przykłady skrajnych przypadków: akceptacja

Poniższe przykłady dotyczą sytuacji, w których verdict wskazuje problemy z jakością, które wymagają dalszego zbadania. Przykłady te pokazują też, w jaki sposób Twoja logika może przenosić się od wyniku do komponentów adresu, aby uzyskać pełniejszy obraz w celu ulepszenia logiki systemu.

Niepotwierdzony numer ulicy poza Stanami Zjednoczonymi

Ten przykład ilustruje wpis adresu w języku włoskim ze wszystkimi składnikami adresu, bez komponentów wywnioskowanych ani zastąpionych. validationGranularity to jednak ROUTE.

Wpisano adres Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

Decyzja dotycząca niepotwierdzonego numeru budynku

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

Po dokładnym sprawdzeniu elementów adresu stwierdziliśmy, że numer domu to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer ulicy w USA

Ten przykład przedstawia wpis w Stanach Zjednoczonych ze wszystkimi składnikami adresu, bez elementów wywnioskowanych ani zastąpionych. validationGranularity to jednak PREMISE_PROXIMITY.

Wpisano adres Region
975 Carson Dr, Sunnyvale, CA 94086, USA PL

Dane USPS dla niepotwierdzonego numeru budynku

{
   "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 wpis w Stanach Zjednoczonych z potwierdzoną wartością wszystkich komponentów adresu, bez elementów wywnioskowanych ani zastąpionych, oraz z polem validationGranularity o wartości PREMISE. Pole uspsData nie jest jednak w pełni wypełnione i nie zawiera wartości dpvConfirmation.

Wpisano adres Region
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 PL

Ocena potwierdzonego adresu z niepełnymi danymi USPS

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

dane USPS dotyczące potwierdzonego adresu i niepełnych danych 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"
}