이 문서에서는 Address Validation API가 시스템에서 수락해야 하는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 컨텍스트를 위해 유효성 검사 응답 사용의 워크플로 개요를 참고하세요.
일반적인 예: 수락
이 시나리오는 시스템에서 고객이 입력한 주소를 허용하는 주소를 보여줍니다.
입력된 주소 | 지역 |
---|---|
서울시 강남구 상상로123 456 | 영국 |
허용되는 주소에 대한 확인 결과
아래 예에서는 중요한 신호를 강조 표시합니다.
{
"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
입니다.
주소 입력됨 | 지역 |
---|---|
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"
}