Popraw adres – przykłady

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.