Akceptowanie adresu – przykłady

W tym dokumencie opisano kilka rzeczywistych sytuacji, w których Interfejs Address Validation API dostarcza sygnały wymagające odpowiedzi, które wymagają zaakceptowania z Twojego systemu. Zobacz Omówienie przepływu pracy w Użyj odpowiedzi weryfikacyjnej, aby uzyskać kontekst.

Typowy przykład: akceptacja

Ten scenariusz ilustruje adres, w którym system akceptowałby adres podany 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 adres problemy z jakością, które wymagają dalszego zbadania. Również w tych przykładach zilustruj, jak logika może przejść od wyniku do składowych adresu aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.

Niepotwierdzony numer budynku (poza USA)

Ten przykład ilustruje wprowadzanie adresu we Włoszech ze wszystkimi składnikami adresu i nie zawiera żadnych wykrytych ani zastąpionych komponentów. Jednak Obecny stan „validationGranularity”: 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
}

Dalsze badanie składników adresu wykazało, że ulica numer 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 bez elementów wywnioskowanych ani zastąpionych. Jednak Obecny stan „validationGranularity”: PREMISE_PROXIMITY.

Wpisano adres Region
975 Carson Dr, Sunnyvale, CA 94086, USA Stany Zjednoczone

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 ilustruje wprowadzanie adresu w Stanach Zjednoczonych ze wszystkimi składnikami adresu potwierdzono bez żadnych domniemanych ani zastąpionych komponentów, oraz validationGranularity z PREMISE. uspsData nie jest jednak w pełni kompletny jest wypełnione i nie zawiera wartości dpvConfirmation.

Wpisano adres Region
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 Stany Zjednoczone

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