Akceptowanie adresu – przykłady

Ten dokument opisuje kilka rzeczywistych sytuacji, w których interfejs Address Validation API dostarcza sygnały odpowiedzi, które pozwalają zaakceptować działanie systemu. Kontekst znajdziesz w omówieniu przepływu pracy artykułu Używanie odpowiedzi weryfikacyjnej.

Typowy przykład: akceptacja

Ten scenariusz ilustruje adres, w którym system akceptuje adres wpisany przez klienta.

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

Ocena akceptowanego adresu

W przykładzie poniżej pokazujemy najważniejsze sygnały.

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

Dodatkowo odpowiedź zawiera te informacje:

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

Połączenie tych sygnałów wskazuje na wysoką jakość adresu.

Przykłady skrajnych przypadków: akceptuj

Poniższe przykłady opisują sytuacje, w których verdict wskazuje rozwiązanie problemów z jakością, które wymagają dalszych analiz. Te przykłady pokazują też, jak logika może przejść od wyniku do składników adresu w celu uzyskania pełniejszego obrazu i ulepszenia logiki systemowej.

Niepotwierdzony numer budynku (poza USA)

Ten przykład ilustruje wpis adresu we Włoszech ze wszystkimi komponentami adresu, ale nie zawiera elementów domniemanych ani zastąpionych. Jednak validationGranularity to ROUTE.

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

Ocena niepotwierdzonego numeru budynku

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

Po dokładnym sprawdzeniu komponentów adresu okazało się, że numer domu to UNCONFIRMED_BUT_PLAUSIBLE.

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

Niepotwierdzony numer budynku w USA

Ten przykład ilustruje wprowadzanie adresu w Stanach Zjednoczonych ze wszystkimi składnikami adresu, które nie zostały zadeklarowane ani zastąpione. Jednak validationGranularity to PREMISE_PROXIMITY.

Wpisano adres Region
975 Carson Dr, Sunnyvale, CA 94086, USA US

Dane USPS dotyczące niepotwierdzonego numeru budynku

{
   "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 pokazuje wpisanie adresu w Stanach Zjednoczonych z potwierdzonymi wszystkimi składnikami adresu bez wnioskowanych ani zastąpionych komponentów oraz jako validationGranularity o wartości PREMISE. Pole uspsData nie jest jednak 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

Ocena potwierdzonego adresu z niepełnymi danymi USPS

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

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