주소 수정 - 예시

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

일반적인 예: 수정

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

도시 및 우편번호 누락

다음 예는 도시 또는 우편번호 없이 상세 주소만 있는 항목을 보여줍니다.

주소 입력됨 리전
21 45 40th 미국

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

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

{
  "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로 반환합니다.

번지 누락

이 예는 누락된 번지수를 보여줍니다.

주소 입력됨 리전
버킹엄 팰리스 로드, SW1W 9TQ London 영국
번지 누락에 대한 결과
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

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

"missingComponentTypes": [
        "street_number"
      ]

특이 사례 예시: 수정

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

확인되지 않은 번지

이 시나리오에서 Address Validation API는 제공된 상세 번호를 확인할 수 없지만 주소가 완전함을 나타냅니다.

주소 입력됨 리전
84 Buckingham Castle 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 코드를 제공하며 이 코드도 누락된 하위 전제를 나타냅니다.