Akceptowanie adresu – przykłady

W tym dokumencie opisujemy kilka rzeczywistych scenariuszy, w których interfejs Address Validation API zwraca sygnały odpowiedzi uzasadniające akceptację przez Twój system. 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.

Wpisano adres Region
76 Buckingham Palace Road, Londyn SW1W 9TQ Wielka Brytania

Werdykt dotyczący akceptowalnego adresu

W przykładzie poniżej wyróżniliśmy 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 adres o wysokiej jakości.

Przykłady przypadków granicznych: akceptacja

Poniższe przykłady obejmują sytuacje, w których symbolverdict wskazuje problemy z jakością adresu, które wymagają dalszego zbadania. Te przykłady 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.

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

Werdykt dotyczący niepotwierdzonego numeru ulicy

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

Dalsza analiza komponentów adresu ujawnia, że poziom potwierdzenia 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 wprowadzanie adresu w Stanach Zjednoczonych ze wszystkimi komponentami adresu, bez komponentów wywnioskowanych lub zastąpionych. Jednak validationGranularity to PREMISE_PROXIMITY.

Wpisano adres Region
975 Carson Dr, Sunnyvale, CA 94086, USA 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 Stanach Zjednoczonych ze wszystkimi potwierdzonymi komponentami adresu, bez komponentów wywnioskowanych lub zastąpionych, oraz z validationGranularity o wartości PREMISE. Jednak pole uspsData nie jest w pełni wypełnione i nie zawiera wartości dpvConfirmation.

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