Akceptowanie adresu – przykłady

W tym dokumencie opisano kilka scenariuszy, w których interfejs Address Validation API dostarcza sygnałów odpowiedzi, które gwarantują akceptację ze strony 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 adres, który Twój system zaakceptuje, gdy klient poda go w formularzu.

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

Werdykt dotyczący akceptowalnego adresu

Przykład poniżej pokazuje ważne 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łączone ze sobą sygnały wskazują na adres o wysokiej jakości.

Przykłady przypadków szczególnych: zaakceptuj

Poniższe przykłady obejmują sytuacje, w których znak 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 werdyktu 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 lub zastąpionych komponentów. Jednak validationGranularity to ROUTE.

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

Wyrok w sprawie niezweryfikowanego numeru ulicy

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

Po dokładnym sprawdzeniu elementów adresu okazało się, ż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 wpis adresu w Stanach Zjednoczonych ze wszystkimi komponentami adresu, bez żadnych komponentów wywnioskowanych ani zastąpionych. Jednak validationGranularity to PREMISE_PROXIMITY.

Adres 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 przedstawia wpis adresu w Stanach Zjednoczonych ze wszystkimi potwierdzonymi komponentami adresu, bez komponentów wywnioskowanych ani zastąpionych oraz z validationGranularity PREMISE. Jednak parametr uspsData nie jest w pełni wypełniony i nie zawiera wartości dpvConfirmation.

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

Werdykt dotyczący 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"
}