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 Korzystanie z odpowiedzi weryfikacji.

Typowy przykład: akceptacja

Ten scenariusz ilustruje adres, który Twój system zaakceptuje po wpisaniu go przez klienta.

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, że:

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

W połączeniu 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. Przykłady te pokazują też, jak logika może przechodzić od wyniku do komponentów adresu, aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.

Niepotwierdzony numer domu spoza Stanów Zjednoczonych

Ten przykład ilustruje wpisanie włoskiego adresu ze wszystkimi komponentami adresu, 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 Stanach Zjednoczonych

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

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

Dane USPS dotyczące 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",
}

Niekompletne dane USPS dotyczące potwierdzonego adresu

Ten przykład ilustruje wpisanie adresu w Stanach Zjednoczonych ze wszystkimi komponentami adresu potwierdzonymi, bez komponentów wywnioskowanych ani zastąpionych, a także z validationGranularity równą PREMISE. Jednak uspsData nie jest w pełni wypełniona 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 niekompletnymi danymi USPS

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

Dane USPS dotyczące potwierdzonego adresu z niekompletnymi 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"
}