주소 수락 - 예시

이 문서에서는 Address Validation API가 시스템에서 수락해야 하는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 관련 컨텍스트는 유효성 검사 응답 사용의 워크플로 개요를 참고하세요.

일반적인 예: 수락

이 시나리오에서는 고객이 입력한 주소를 시스템에서 허용하는 주소를 보여줍니다.

주소 입력됨 지역
서울시 강남구 상상로123 456 UK

허용되는 주소에 대한 결과

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

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

이외에도 응답은 다음을 나타냅니다.

  • hasUnconfirmedComponents는 false로 남아 있음
  • hasInferredComponents는 false로 남아 있음
  • hasReplacedComponents는 false로 남아 있음

이러한 신호를 함께 사용하면 고품질 주소를 나타냅니다.

예외적인 케이스 예시: 수락

다음 예에서는 verdict가 추가 조사가 필요한 품질 문제를 해결하는 상황을 다룹니다. 또한 이 예는 시스템 로직을 개선하기 위해 로직이 확인 결과에서 주소 구성요소로 이동하여 더 완전한 그림을 얻는 방법을 보여줍니다.

미국 이외 국가의 미확인 번지

이 예에서는 추론되거나 대체된 구성요소가 없는 상태에서 모든 주소 구성요소가 있는 이탈리아 주소 항목을 보여줍니다. 하지만 validationGranularity은 ROUTE입니다.

주소 입력됨 지역
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

확인되지 않은 번지에 대한 결과

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

주소 구성요소를 추가로 조사한 결과 번지가 UNCONFIRMED_BUT_PLAUSIBLE인 것으로 밝혀졌습니다.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

미국의 확인되지 않은 번지

이 예에서는 추론되거나 대체된 구성요소가 없는 모든 주소 구성요소가 있는 미국 주소 항목을 보여줍니다. 하지만 validationGranularity은 PREMISE_PROXIMITY입니다.

주소 입력됨 지역
서울특별시 강남구 테헤란로 152 강남파이낸스센터 22층 US

확인되지 않은 번지에 대한 USPS 데이터

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

확인된 주소에 대한 불완전한 USPS 데이터

이 예에서는 모든 주소 구성요소가 확인되었고 추론되거나 대체된 구성요소 없이 그리고 validationGranularity이 PREMISE인 미국 주소 항목을 보여줍니다. 하지만 uspsData는 완전히 채워지지 않으며 dpvConfirmation 값을 포함하지 않습니다.

주소 입력됨 지역
서울특별시 강남구 테헤란로 152 강남파이낸스센터 22층 US

불완전한 USPS 데이터가 포함된 확인된 주소에 대한 결과

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

불완전한 USPS 데이터가 포함된 확인된 주소의 USPS 데이터

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}