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 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 Twój system powinien obsługiwać 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 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 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.

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 wywnioskowanych ani zastąpionych komponentów. 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 validationGranularity 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 US

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