Dodawanie pomieszczeń w ramach obiektu – przykłady (tylko Stany Zjednoczone)

W tym dokumencie opisujemy kilka rzeczywistych scenariuszy, w których interfejs Address Validation API dostarcza sygnały odpowiedzi, które uzasadniają zachowanie systemu polegające na dodaniu lokalu. Te sygnały są dostępne tylko w przypadku adresów w Stanach Zjednoczonych. Więcej informacji znajdziesz w sekcji Przykładowe przepływy pracy w artykule Tworzenie logiki weryfikacji.

Typowy przykład: dodawanie lokali

Ten scenariusz przedstawia adres, w przypadku którego system może poprosić klienta o dodanie numeru lokalu.

Werdykt dotyczący adresu, w którym brakuje informacji o lokalu

Poniższy przykład pokazuje ważny sygnał.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Przykład nietypowego przypadku: dodawanie podlokalu

Poniższy przykład dotyczy sytuacji, w której verdict wskazuje na problemy z jakością adresu, które wymagają dalszego zbadania. Ten przykład pokazuje też, jak logika może przechodzić od werdyktu do komponentów adresu, aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.

Brakujące lokale podrzędne oraz komponenty wywnioskowane i zastąpione

Ten przykład pokazuje wpisanie adresu w USA z brakującą miejscowością i nieprawidłowym kodem pocztowym.

Werdykt dotyczący brakującego lokalu oraz komponentów wywnioskowanych i zastąpionych

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Dalsza analiza komponentów adresu pokazuje, że miejscowość została wywnioskowana, a kod pocztowy został zastąpiony.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}