Akceptowanie adresu – przykłady

W tym dokumencie opisaliśmy kilka rzeczywistych scenariuszy, w których interfejs Address Validation API zapewnia sygnały odpowiedzi, które gwarantują akceptację ze strony Twojego systemu. Aby uzyskać kontekst, zapoznaj się z artykułem Omówienie procesu w sekcji Używanie odpowiedzi z weryfikacji.

Typowy przykład: accept

Ten scenariusz pokazuje, jak system zareaguje na adres wpisany przez klienta.

Adres został wpisany Region
76 Buckingham Palace Road, Londyn SW1W 9TQ Wielka Brytania

Ocena akceptowanego adresu

W przykładzie poniżej pokazujemy najważniejsze sygnały.

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

Dodatkowo odpowiedź zawiera te informacje:

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

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

Przykłady przypadków szczególnych: zaakceptuj

Poniższe przykłady obejmują sytuacje, w których verdict wskazuje na problemy z jakością adresów, które wymagają dalszego zbadania. Przykłady te pokazują też, jak logika może przechodzić z wyroku do elementów adresu, aby uzyskać pełniejszy obraz i ulepszać logikę systemu.

Niepotwierdzony numer ulicy poza USA

Ten przykład ilustruje wpis adresu włoskiego ze wszystkimi komponentami adresu, bez żadnych wywnioskowanych lub zastąpionych komponentów. Natomiast validationGranularity to ROUTE.

Wpisano adres Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Włochy IT

Ocena niepotwierdzonego numeru budynku

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

Po dokładnym sprawdzeniu komponentów adresu okazało się, że numer domu to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w USA

Ten przykład ilustruje wpis adresu w Stanach Zjednoczonych ze wszystkimi komponentami adresu, bez żadnych komponentów wywnioskowanych ani zastąpionych. Jednak validationGranularity to PREMISE_PROXIMITY.

Adres został wpisany Region
975 Carson Dr, Sunnyvale, CA 94086, USA Stany Zjednoczone

Dane USPS dla niezweryfikowanego numeru ulicy

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

Niepełne dane USPS dla potwierdzonego adresu

Ten przykład pokazuje wpisanie adresu w Stanach Zjednoczonych z potwierdzonymi wszystkimi składnikami adresu bez wnioskowanych ani zastąpionych komponentów oraz jako validationGranularity o wartości PREMISE. Jednak parametr uspsData nie jest w pełni wypełniony i nie zawiera wartości dpvConfirmation.

Adres został wpisany Region
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 Stany Zjednoczone

Werdykt dla potwierdzonego adresu z niekompletnymi danymi USPS

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

Dane USPS dla potwierdzonego adresu z niepełnymi 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"
}