주소 수정 - 예시

이 문서에서는 Address Validation API가 시스템의 수정 동작을 정당화하는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 관련 내용은 유효성 검사 로직 빌드의 워크플로 개요를 참고하세요.

일반적인 예: 수정

이 섹션에서는 Address Validation 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 코드를 제공합니다.