W tym dokumencie opisujemy kilka rzeczywistych scenariuszy, w których interfejs Address Validation API zwraca sygnały odpowiedzi uzasadniające dodanie podrzędnych lokali przez Twój system. 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 pomieszczeń pomocniczych
Ten scenariusz ilustruje adres, w przypadku którego system może poprosić klienta o dodanie numeru lokalu.
Wpisano adres | Region |
---|---|
1450 Brickell Avenue, Miami, FL 33131-4065 | US |
Decyzja dotycząca adresu, w którym brakuje podrzędnego obiektu
Ważny sygnał jest wyróżniony w przykładzie poniżej.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Przykład: dodawanie podlokalizacji
Poniższy przykład dotyczy sytuacji, w której symbol verdict
wskazuje problemy z jakością adresu, które wymagają dalszego zbadania. Ten przykład pokazuje też, jak logika może przechodzić od wyniku do komponentów adresu, aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.
Brakujące podlokalizacje oraz wywnioskowane i zastąpione komponenty
Ten przykład ilustruje wpisanie adresu w Stanach Zjednoczonych, w którym brakuje miejscowości i jest nieprawidłowy kod pocztowy.
Wpisano adres | Region |
---|---|
1450 Brickell Avenue, FL 33132-4065 | US |
Werdykt w przypadku braku podrzędnych obiektów i wywnioskowanych oraz zastąpionych komponentów
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true,
"hasReplacedComponents": true,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Dalsza analiza elementów adresu ujawnia, ż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
}