Akceptowanie adresu – przykłady

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

Typowy przykład: akceptowanie

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óżniliśmy ważne sygnały.

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

Oprócz tego odpowiedź zawiera te informacje:

• hasUnconfirmedComponents pozostało false
• hasInferredComponents pozostało false
• hasReplacedComponents pozostało false
• hasSpellCorrectedComponents pozostało false

W połączeniu te sygnały wskazują na adres o wysokiej jakości.

Przykłady przypadków granicznych: akceptacja

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

Niepotwierdzony numer domu spoza Stanów Zjednoczonych

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

Werdykt dotyczący niepotwierdzonego numeru ulicy

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

Dalsza analiza elementów adresu ujawnia, że numer ulicy to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w Stanach Zjednoczonych

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

Dane USPS dla 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",
}

Niepełne dane USPS dla potwierdzonego adresu

Ten przykład ilustruje wpisanie adresu w Stanach Zjednoczonych ze wszystkimi potwierdzonymi komponentami adresu, bez komponentów wywnioskowanych ani zastąpionych, oraz z poziomem ufności validationGranularity wynoszącym PREMISE. Pole uspsData nie jest jednak w pełni wypełnione i nie zawiera wartości dpvConfirmation.

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