주소 수락 - 예시

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

일반적인 예: 수락

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

입력된 주소 리전
76 Buckingham Palace Road, London SW1W 9TQ 영국

수락 가능한 주소에 대한 판정

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

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

이 외에도 verdict 는 다음을 나타냅니다.

  • 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입니다.

입력된 주소 리전
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 데이터

이 예에서는 추론되거나 대체된 구성요소 없이 모든 주소 구성요소가 확인되고 validationGranularity 이 PREMISE인 미국 주소의 입력을 보여줍니다. 그러나 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"
}