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 Przegląd przepływu pracy w sekcji Tworzenie logiki sprawdzania.

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 odpowiedź zawiera te informacje:

  • hasUnconfirmedComponents pozostaje false
  • hasInferredComponents pozostaje false
  • hasReplacedComponents pozostaje false
  • hasSpellCorrectedComponents 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ą 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 ani 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 dla 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 domu 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. Jednak 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 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"
}