주소 수락 - 예시

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

일반적인 예: 수락

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

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

허용되는 주소에 대한 평결

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

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

또한 응답에는 다음이 표시됩니다.

  • hasUnconfirmedComponentsfalse로 남아 있음
  • hasInferredComponentsfalse로 남아 있음
  • hasReplacedComponentsfalse로 남아 있음
  • hasSpellCorrectedComponentsfalse로 남아 있음

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

특이 사례 예: 수락

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

미국 외 지역의 확인되지 않은 번지

이 예시에서는 추론되거나 대체된 구성요소 없이 모든 주소 구성요소가 있는 이탈리아 주소의 입력을 보여줍니다. 하지만 validationGranularityROUTE입니다.

주소 입력됨 지역
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"
}

미국에서 확인되지 않은 번지

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

주소 입력됨 지역
975 Carson Dr, Sunnyvale, CA 94086 미국

확인되지 않은 번지에 대한 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 데이터가 불완전함

이 예시에서는 모든 주소 구성요소가 확인되고 추론되거나 대체된 구성요소가 없으며 validationGranularityPREMISE인 미국 주소의 입력을 보여줍니다. 하지만 uspsData가 완전히 채워지지 않고 dpvConfirmation 값이 포함되어 있지 않습니다.

주소 입력됨 지역
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 미국

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"
}