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 weryfikacyjnej.

Typowy przykład: akceptowanie

Ten scenariusz ilustruje adres, w przypadku którego system zaakceptuje adres wpisany przez klienta.

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

Ocena akceptowalnego adresu

Poniższy przykład pokazuje ważne sygnały.

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

Oprócz tego symbol verdict oznacza:

  • hasUnconfirmedComponents pozostało false
  • hasInferredComponents pozostało false
  • hasReplacedComponents pozostało false

W połączeniu te sygnały wskazują na wysoką jakość adresu.

Przykłady przypadków skrajnych: akceptacja

Poniższe przykłady ilustrują sytuacje, w których symbol verdict wskazuje 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 wprowadzanie włoskiego adresu ze wszystkimi komponentami adresu, bez komponentów wywnioskowanych lub zastąpionych. Jednak validationGranularity to ROUTE.

Wpisany adres Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Włochy IT

Werdykt dotyczący niepotwierdzonego numeru domu

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

Dalsza analiza komponentów adresu pokazuje, że poziom potwierdzenia numeru domu wynosi UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer domu w USA

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

Wpisany adres Region
975 Carson Dr, Sunnyvale, CA 94086, Stany Zjednoczone 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 dla potwierdzonego adresu

Ten przykład ilustruje wpisanie adresu w Stanach Zjednoczonych ze wszystkimi potwierdzonymi komponentami adresu, bez komponentów wywnioskowanych lub zastąpionych, oraz z validationGranularity wartością PREMISE. Pole uspsData nie jest jednak w pełni wypełnione i nie zawiera wartości dpvConfirmation.

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

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