Popraw adres – przykłady

W tym dokumencie opisano kilka rzeczywistych scenariuszy, w których interfejs Address Validation API dostarcza sygnałów odpowiedzi, które uzasadniają poprawkę w systemie. Aby uzyskać kontekst, zapoznaj się z artykułem Przegląd przepływu pracy w sekcji Tworzenie logiki sprawdzania.

Typowe przykłady: poprawka

W tej sekcji opisano typowe przykłady, w których interfejs API weryfikacji adresu dostarcza sygnałów odpowiedzi wskazujących na niską jakość informacji o adresie.

Brak miasta i kodu pocztowego

Ten przykład ilustruje wpis zawierający tylko adres ulicy bez miasta lub kodu pocztowego.

Adres został wpisany Region
21 45 40th street USA

Werdykt dotyczący braku miasta i kodu pocztowego

Przykład poniżej podkreśla ważne sygnały z odpowiedzi.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Te sygnały wskazują na adres, na który nie można dostarczyć wiadomości. Aby dowiedzieć się więcej, możesz wysłać zapytanie do addressComponents:

{
  "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 API weryfikacji adresu zwraca tylko kraj (Stany Zjednoczone) jako CONFIRMED. Zwraca wszystkie inne elementy adresu jako UNCONFIRMED_BUT_PLAUSIBLE, z niektórymi ważnymi pominięciami danych, takimi jak miejscowość i kod pocztowy.

Brak numeru budynku

W tym przykładzie brakuje numeru domu.

Adres został wpisany Region
Buckingham Palace Road, SW1W 9TQ, Londyn Wielka Brytania
Werdykt dotyczący braku numeru ulicy
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity to ROUTE, co wskazuje na dopasowanie do ulicy, ale nie zawiera wystarczających informacji, aby dotrzeć do budynku. Ponadto w wyroku brakuje właściwości addressComplete, dlatego jest on false. Kolejne zapytanie dotyczące obiektu addresspokazuje brakujący typ komponentu:

"missingComponentTypes": [
        "street_number"
      ]

Przykłady przypadków szczególnych: poprawka

W niektórych sytuacjach naprawa, potwierdzenie lub zaakceptowanie adresu zależy od konkretnego scenariusza biznesowego. Przykłady poniżej pokazują sytuacje, które nie mieszczą się w ścisłej definicji danej kategorii poprawek.

Niepotwierdzony numer domu

W takim przypadku interfejs Address Validation API nie może potwierdzić podanego numeru domu, ale wskazuje, że adres jest kompletny.

Adres został wpisany Region
84 Buckingham Palace Road, SW1W 9TQ, Londyn Wielka Brytania

Werdykt dotyczący niezweryfikowanego numeru ulicy

Przykład poniżej podkreśla ważne sygnały.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

Warto sprawdzić, czy połączenie weryfikacji z poziomem dokładności na poziomie lokalnym i niepotwierdzonych komponentów nie przyniesie lepszych wyników. Zapytanie dotyczące właściwości addressComponents zwraca tę niepotwierdzoną wartość componentType:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

W tym przypadku confirmation_level street_number ma wartość UNCONFIRMED_BUT_PLAUSIBLE. Niepotwierdzony oznacza, że usługa nie może dopasować numeru ulicy 84 do swojego zbioru danych, a wiarygodny oznacza, że dane komponentu mogą być nadal prawidłowe.

Brak podrzędnego pomieszczenia

Ten scenariusz opisuje adres, w którym brakuje tylko lokalu, np. mieszkania lub pokoju. W przeciwnym razie interfejs API do weryfikacji adresów może w pełni zweryfikować adres. Podobnie jak w przypadku braku któregokolwiek elementu adresu, addressComplete to false, dlatego nie jest widoczny podczas ręcznego sprawdzania oceny.

Na przykład klient podaje prawidłowy adres urzędu miasta w San Francisco, ale pomija numer pokoju.

Adres został wpisany Region
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 USA

Werdykt dotyczący braku podrzędnej lokalizacji

W tym przykładzie werdykt nie zawiera właściwości addressComplete, więc jest to false. Dzięki temu wiesz, że co najmniej 1 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 dalszych poszukiwaniach dane USPS podają kod dpvConfirmationD, który również wskazuje na brak lokalizacji podrzędnej.