Akceptowanie adresu – przykłady

W tym dokumencie opisaliśmy kilka rzeczywistych scenariuszy, w których interfejs Address Validation API dostarcza sygnałów odpowiedzi, które gwarantują akceptację przez Twój system. Aby uzyskać kontekst, zapoznaj się z omówieniem procesu w artykule Używanie odpowiedzi weryfikacyjnej.

Typowy przykład: zaakceptuj

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

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

Werdykt dotyczący akceptowalnego adresu

Przykład poniżej wyróżnia ważne sygnały.

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

Dodatkowo verdict oznacza:

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

Połączone ze sobą sygnały wskazują na adres o wysokiej jakości.

Przykłady przypadków szczególnych: zaakceptuj

Poniższe przykłady dotyczą sytuacji, w których verdict wskazuje na problemy z jakością adresu, 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.

Niezweryfikowany numer ulicy poza Stanami Zjednoczonymi

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

Adres został wpisany Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Włochy IT

Wyrok dla niezweryfikowanego numeru ulicy

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

Dalsze sprawdzenie elementów adresu ujawnia, że poziom potwierdzenia numeru ulicy to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w Stanach Zjednoczonych

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

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

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 ilustruje wpis adresu w Stanach Zjednoczonych ze wszystkimi potwierdzonymi komponentami adresu, bez komponentów wywnioskowanych ani zastąpionych oraz z validationGranularityPREMISE. 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 US

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