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 accept w Twoim systemie. Więcej informacji znajdziesz w sekcji Omówienie przepływu pracy w artykule Używanie odpowiedzi weryfikacyjnej.

Typowy przykład: akceptacja

Ten scenariusz ilustruje adres, który Twój system zaakceptuje.

Wpisany adres Region
76 Buckingham Palace Road, London SW1W 9TQ Wielka Brytania

Wynik dla akceptowalnego adresu

Poniższy przykład wyróżnia ważne sygnały.

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

Oprócz tego verdict wskazuje:

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

Te sygnały wskazują na adres wysokiej jakości.

Przykłady przypadków brzegowych: akceptacja

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

Niepotwierdzony numer domu spoza USA

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

Wpisany adres Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

Wynik dla niepotwierdzonego numeru domu

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

Dalsze badanie komponentów adresu ujawnia, że poziom potwierdzenia dla numeru domu to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w USA

Ten przykład ilustruje wpisanie adresu w USA ze wszystkimi komponentami, bez komponentów wywnioskowanych ani zastąpionych. Jednak validationGranularity to PREMISE_PROXIMITY.

Wpisany adres Region
975 Carson Dr, Sunnyvale, CA 94086 US

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

Wpisany adres Region
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 US

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