Ten dokument opisuje kilka rzeczywistych scenariuszy, w których interfejs Address Validation API dostarcza sygnały odpowiedzi, które uzasadniają fix działania systemu. Kontekst znajdziesz w artykule Omówienie przepływu pracy w artykule Tworzenie logiki weryfikacji.
Typowe przykłady: naprawianie
W tej sekcji znajdziesz typowe przykłady, w których interfejs Address Validation API dostarcza sygnały odpowiedzi wskazujące mniejszą jakość informacji o adresie.
Brak miasta i kodu pocztowego
Ten przykład pokazuje wpis zawierający tylko adres bez miasta i kodu pocztowego.
Wpisano adres | Region |
---|---|
21 45 40th Street | USA |
Decyzja dotycząca brakującego miasta i kodu pocztowego
Poniższy przykład przedstawia ważne sygnały z odpowiedzi.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Sygnały te wskazują, że adres, którego nie można dostarczyć, jest niemożliwy do dostarczenia, możesz więc wysłać zapytanie na addressComponents
, aby dowiedzieć się więcej:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
Interfejs Address Validation API zwraca jedynie kraj (Stany Zjednoczone) jako CONFIRMED
.
Zwraca wszystkie pozostałe komponenty adresu jako UNCONFIRMED_BUT_PLAUSIBLE
z ważnymi pominięciem danych, np. nazwą miejscowości i kodem pocztowym.
Brak numeru budynku
Ten przykład pokazuje brakujący numer domu.
Wpisano adres | Region |
---|---|
Buckingham Palace Road, SW1W 9TQ London | Wielka Brytania |
Wniosek dotyczący braku numeru domu
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity
to ROUTE
, co wskazuje dopasowanie do ulicy, ale za mało informacji, by można było dojechać do budynku. W wyniku brakuje też właściwości addressComplete
, dlatego jest to false
. Dalsze zapytanie dotyczące obiektu address
ujawnia brakujący typ komponentu:
"missingComponentTypes": [
"street_number"
]
Przykłady przypadków skrajnych: naprawienie
W niektórych sytuacjach to, czy naprawisz, potwierdzisz lub zaakceptujesz adres, zależy od konkretnej sytuacji biznesowej. Poniższe przykłady pokazują sytuacje, które niekoniecznie muszą należeć do kategorii „tradycyjne”.
Niepotwierdzony numer domu
W takiej sytuacji interfejs Address Validation API nie może potwierdzić podanego numeru domu, ale wskazuje, że adres jest pełny.
Wpisano adres | Region |
---|---|
84 Buckingham Palace Road, SW1W 9TQ, Londyn | Wielka Brytania |
Decyzja dotycząca niepotwierdzonego numeru domu
Poniższy przykład skupia się na ważnych sygnałach.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Warto zbadać połączenie szczegółowości weryfikacji tylko z przybliżeniem na poziomie budynku i niepotwierdzonymi komponentami. Zapytanie we właściwości addressComponents
wyświetla te niepotwierdzone elementy componentType
:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
W tym przypadku confirmation_level
elementu street_number
jest ustawiony na UNCONFIRMED_BUT_PLAUSIBLE
. Wartość Niepotwierdzone oznacza, że usługa nie może pasować do numeru domu 84 w zbiorze danych, a prawdopodobne oznacza, że dane składowe wciąż mogą być prawidłowe.
Brak zasobu podrzędnego
Ten scenariusz opisuje adres, w którym brakuje tylko nazwy podrzędnej, np. numeru mieszkania lub działu. W przeciwnym razie interfejs Address Validation API może w pełni zweryfikować adres. Tak jak w przypadku braku dowolnego składnika adresu, addressComplete
ma wartość false
i dlatego nie pojawia się podczas ręcznego sprawdzania wyniku.
Załóżmy, że klient wpisuje prawidłowy adres biura rzeczoznawcy w Krakowie, ale brakuje w nim numeru sali.
Wpisano adres | Region |
---|---|
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102, USA | USA |
Wynik dotyczący braku adresu podrzędnego
W tym przykładzie wynik nie zawiera właściwości addressComplete
, więc jest to false
. Wiesz, że co najmniej jeden element adresu jest niespodziewany, nierozwiązany lub nie istnieje.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Zapytanie address
ujawnia te informacje:
"missingComponentTypes": [
"subpremise"
]
Po zbadaniu sprawy dowiedzieliśmy się, że dane USPS udostępniają kod dpvConfirmation
o wartości D
, który wskazuje też brakujący lokal.