Ten dokument opisuje kilka rzeczywistych sytuacji, w których interfejs Address Validation API dostarcza sygnały odpowiedzi, które wymagają fix przez system. Kontekst znajdziesz w omówieniu przepływu pracy artykułu Tworzenie logiki weryfikacji.
Typowe przykłady: poprawka
W tej sekcji znajdziesz typowe przykłady, w których interfejs Address Validation API dostarcza sygnały odpowiedzi wskazujące na gorszą jakość informacji adresowych.
Brak miasta i kodu pocztowego
Ten przykład ilustruje wpis zawierający tylko ulicę, bez nazwy miasta ani kodu pocztowego.
| Wpisano adres | Region |
|---|---|
| ul. Rybaki 13 | USA |
Wniosek dotyczący brakującego miasta i kodu pocztowego
W przykładzie poniżej podkreślono ważne sygnały z odpowiedzi.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Te sygnały wskazują na adres, którego nie można dostarczyć, więc możesz wysłać zapytanie do addressComponents, aby uzyskać więcej informacji:
{
"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 tylko kraj (Stany Zjednoczone) jako CONFIRMED.
Pozostałe komponenty adresu zwracają wartość UNCONFIRMED_BUT_PLAUSIBLE, z pewnymi ważnymi pominięciemi w danych, takich jak miejscowość czy kod pocztowy.
Brak numeru budynku
Ten przykład pokazuje brakujący numer domu.
| Wpisano adres | Region |
|---|---|
| Buckingham Palace Road, SW1W 9TQ Londyn | Wielka Brytania |
Decyzja dotycząca brakującego numeru budynku
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity to ROUTE, co oznacza dopasowanie do ulicy, ale brak wystarczających informacji, aby dotrzeć do obiektu. Oprócz tego w wyniku brakuje właściwości addressComplete, dlatego jest to false. Kolejne zapytanie obiektu address wskazuje brakujący typ komponentu:
"missingComponentTypes": [
"street_number"
]
Przykłady skrajnych liter: poprawka
W niektórych sytuacjach to, czy poprawisz, potwierdzisz lub zaakceptujesz adres, zależy od scenariusza biznesowego. Poniższe przykłady ilustrują sytuacje, które mogą nie należeć ściśle do kategorii poprawek.
Niepotwierdzony numer budynku
W takim przypadku interfejs Address Validation API nie może potwierdzić podanego numeru domu, ale pokazuje, że adres jest kompletny.
| Wpisano adres | Region |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, Londyn | Wielka Brytania |
Decyzja dotycząca niepotwierdzonego numeru budynku
W przykładzie poniżej podkreślamy ważne sygnały.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Warto zbadać kombinację szczegółowości weryfikacji tylko na potrzeby przybliżenia na poziomie obiektu i niepotwierdzonych komponentów. Zapytanie właściwości addressComponents wyświetla te niepotwierdzone wartości componentType:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Tutaj confirmation_level elementu street_number ma wartość UNCONFIRMED_BUT_PLAUSIBLE. Wartość Niepotwierdzone oznacza, że usługa nie może dopasować się do numeru budynku 84 w zbiorze danych, a Prawdopodobne oznacza, że dane składowe wciąż mogą być prawidłowe.
Brak podstawy podrzędnej
Ten scenariusz dotyczy adresu, w którym brakuje tylko lokalu podrzędnego, 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 któregokolwiek składnika adresu, pole addressComplete ma wartość false i dlatego nie jest ono widoczne podczas ręcznego sprawdzania decyzji.
W tym przykładzie załóżmy, że klient wpisuje prawidłowy adres biura Rzecznika ds. miasta w Krakowie, ale nie podaje numeru sali.
| Wpisano adres | Region |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102, USA | USA |
Decyzja dotycząca brakującego obiektu podrzędnego
W tym przykładzie wynik nie zawiera właściwości addressComplete, więc jest to false. Dzięki temu wiesz, że co najmniej jeden element adresu jest nieoczekiwany,
nierozwiązany lub brakuje go.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Zapytanie address ujawnia te informacje:
"missingComponentTypes": [
"subpremise"
]
Po dokładniejszym zbadaniu sprawy okazało się, że w danych USPS dostarczany jest kod dpvConfirmation z wartością D, który również wskazuje brakujący element podrzędny.