이 문서에서는 주소 유효성 검사 API가 시스템의 수정 동작을 보증할 수 있는 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 컨텍스트는 유효성 검사 로직 빌드의 워크플로 예시를 참고하세요.
일반적인 예: 수정
이 섹션에서는 주소 유효성 검사 API가 품질이 낮은 주소 정보를 나타내는 응답 신호를 제공하는 일반적인 예를 설명합니다.
도시 및 우편번호 누락
이 예시에서는 도시나 우편번호 없이 도로명 주소만 있는 항목을 보여줍니다.
| 주소 입력됨 | 지역 |
|---|---|
| 21 45 40th street | 미국 |
도시 및 우편번호 누락에 대한 평결
아래 예시에서는 응답의 중요한 신호를 강조합니다.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true,
"possibleNextAction": "FIX"
}
possibleNextAction은 주소로 배송할 수 없을 수 있다는 초기 표시를 제공합니다. 강조 표시된 다른 구성요소도 이 가능성을 지원하므로 addressComponents를 쿼리하여 자세히 알아볼 수 있습니다.
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
Address Validation API는 국가 (미국)만 CONFIRMED로 반환합니다.
지역 및 우편번호와 같은 중요한 데이터가 누락된 채로 다른 모든 주소 구성요소를 UNCONFIRMED_BUT_PLAUSIBLE로 반환합니다.
번지 누락
이 예시에서는 번호가 누락된 경우를 보여줍니다.
| 주소 입력됨 | 지역 |
|---|---|
| Buckingham Palace Road, SW1W 9TQ London | 영국 |
번지 누락에 대한 평결
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"possibleNextAction": "FIX"
}
다시 한번 말하지만 possibleNextAction는 주소로 배송되지 않을 수 있다는 초기 표시를 제공합니다. 또한 validationGranularity는 ROUTE입니다. 이는 거리에 일치하지만 건물에 도달하기에 충분한 정보가 없음을 나타냅니다. 또한 addressComplete 속성이 평결에서 누락되어 있으므로 false입니다. address 객체를 추가로 쿼리하면 누락된 구성요소 유형이 표시됩니다.
"missingComponentTypes": [
"street_number"
]
특이 사례 예: 수정
주소를 수정, 확인 또는 수락할지 여부는 특정 비즈니스 시나리오에 따라 다릅니다. 아래 예는 수정 카테고리에 속하지 않을 수 있는 시나리오를 보여줍니다.
확인되지 않은 번지
이 시나리오에서 Address Validation API는 제공된 번지수를 확인할 수 없지만 주소가 완전하다고 표시합니다.
| 주소 입력됨 | 지역 |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, London | 영국 |
확인되지 않은 번지수에 대한 평결
아래 예에서는 중요한 신호를 강조합니다.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true,
"possibleNextAction": "ACCEPT"
}
확인되지 않은 구성요소와 함께 검증 세분성을 전제 수준 근사치로만 조합하는 것을 조사해 볼 만합니다. addressComponents 속성을 쿼리하면 다음과 같은 확인되지 않은 componentType이 표시됩니다.
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
여기서 street_number의 confirmation_level은 UNCONFIRMED_BUT_PLAUSIBLE로 설정됩니다. 확인되지 않음은 서비스가 데이터 세트에서 84번지 주소를 찾을 수 없음을 의미하고, 가능은 구성요소 데이터가 여전히 유효할 수 있음을 의미합니다.
하위 건물 누락
이 시나리오에서는 아파트나 부서 번호와 같은 하위 건물만 누락된 주소를 설명합니다. 그렇지 않으면 Address Validation API에서 주소를 완전히 검증할 수 있습니다. 주소 구성요소가 누락된 경우와 마찬가지로 addressComplete가 false이므로 판결의 수동 검사에는 표시되지 않습니다.
예를 들어 고객이 샌프란시스코 시 평가관 사무실의 유효한 주소를 입력했지만 입력에서 방 번호를 누락한 경우를 가정해 보겠습니다.
| 주소 입력됨 | 지역 |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | 미국 |
누락된 하위 구역에 대한 평결
이 예시에서 평결에는 addressComplete 속성이 표시되지 않으므로 false입니다. 따라서 하나 이상의 주소 요소가 예상치 못하거나, 해결되지 않았거나, 누락되었음을 알 수 있습니다.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
address 쿼리를 통해 다음을 확인할 수 있습니다.
"missingComponentTypes": [
"subpremise"
]
추가 문의 결과 USPS 데이터는 D의 dpvConfirmation 코드를 제공하며, 이는 하위 구역이 누락되었음을 나타냅니다.