주소 수정 - 예시

이 문서에서는 주소 유효성 검사 API가 시스템에서 수정 동작을 보장하는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 여기에 나온 예는 일부에 해당합니다. 컨텍스트는 유효성 검사 로직 빌드의 워크플로 개요를 참고하세요.

일반적인 예: 수정

이 섹션에서는 주소 유효성 검사 API가 품질이 낮은 주소 정보를 나타내는 응답 신호를 제공하는 일반적인 예를 설명합니다.

도시 및 우편번호 누락

이 예시에서는 도시나 우편번호 없이 도로명 주소만 있는 항목을 보여줍니다.

주소 입력됨 지역
21 45 40th street 미국

도시 및 우편번호 누락에 대한 평결

아래 예에서는 응답의 중요한 신호를 강조합니다.

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

이러한 신호는 배송할 수 없는 주소를 나타내므로 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"
}

Address Validation API는 국가 (미국)만 CONFIRMED로 반환합니다. 지역 및 우편번호와 같은 중요한 데이터가 누락된 채로 다른 모든 주소 구성요소를 UNCONFIRMED_BUT_PLAUSIBLE로 반환합니다.

번지 누락

이 예시에서는 번호가 누락된 경우를 보여줍니다.

주소 입력됨 지역
Buckingham Palace Road, SW1W 9TQ London 영국
번지 누락에 대한 평결
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity이 ROUTE입니다. 이는 거리에 일치하지만 건물에 도달하기에는 정보가 충분하지 않음을 나타냅니다. 또한 addressComplete 속성이 평결에서 누락되어 있으므로 false입니다. address 객체를 추가로 쿼리하면 누락된 구성요소 유형이 표시됩니다.

"missingComponentTypes": [
        "street_number"
      ]

특이 사례 예: 수정

주소를 수정, 확인 또는 수락할지 여부는 특정 비즈니스 시나리오에 따라 다릅니다. 아래 예는 수정 카테고리에 정확히 해당하지 않을 수 있는 시나리오를 보여줍니다.

확인되지 않은 번지

이 시나리오에서 Address Validation API는 제공된 번지수를 확인할 수 없지만 주소가 완전하다고 표시합니다.

주소 입력됨 지역
84 Buckingham Palace Road, SW1W 9TQ, London 영국

확인되지 않은 번지수에 대한 평결

아래 예에서는 중요한 신호를 강조합니다.

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

확인되지 않은 구성요소와 함께 검증 세분성만 사용하여 건물 수준 근사치를 조사해 볼 만합니다. addressComponents 속성을 쿼리하면 다음과 같은 확인되지 않은 componentType이 표시됩니다.

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

여기서 street_number의 confirmation_level은 UNCONFIRMED_BUT_PLAUSIBLE로 설정됩니다. 확인되지 않음은 서비스가 데이터 세트에서 84번지 주소를 찾을 수 없음을 의미하고, 가능은 구성요소 데이터가 여전히 유효할 수 있음을 의미합니다.

하위 건물 누락

이 시나리오에서는 아파트나 부서 번호와 같은 하위 건물만 누락된 주소를 설명합니다. 그렇지 않으면 Address Validation API에서 주소를 완전히 검증할 수 있습니다. 주소 구성요소가 누락된 경우와 마찬가지로 addressComplete가 false이므로 판결의 수동 검사에는 표시되지 않습니다.

예를 들어 고객이 샌프란시스코 시 평가관 사무실의 유효한 주소를 입력했지만 입력에서 방 번호를 누락한 경우를 가정해 보겠습니다.

주소 입력됨 지역
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 미국

누락된 하위 구역에 대한 평결

이 예시에서 평결에는 addressComplete 속성이 표시되지 않으므로 false입니다. 따라서 하나 이상의 주소 요소가 예상치 못하거나, 해결되지 않았거나, 누락되었음을 알 수 있습니다.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

address 쿼리를 통해 다음을 확인할 수 있습니다.

"missingComponentTypes": [
        "subpremise"
      ]

추가 문의 결과 USPS 데이터는 D의 dpvConfirmation 코드를 제공하며, 이는 하위 구역이 누락되었음을 나타냅니다.