이 문서에서는 주소 유효성 검사 API가 시스템에서 수락 동작을 보장하는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 컨텍스트는 유효성 검사 로직 빌드의 워크플로 예시를 참고하세요.
일반적인 예: 수락
이 시나리오에서는 시스템이 고객이 입력한 주소를 수락하는 주소를 보여줍니다.
주소 입력됨 | 지역 |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | 영국 |
허용되는 주소에 대한 평결
아래 예에서는 중요한 신호를 강조 표시합니다.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
또한 응답에는 다음이 표시됩니다.
hasUnconfirmedComponents
는false
로 남아 있음hasInferredComponents
는false
로 남아 있음hasReplacedComponents
는false
로 남아 있음hasSpellCorrectedComponents
는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"
}