이 문서에서는 애플리케이션이 실행되는 여러 시나리오에 대해 Address Validation API는 수락 동작을 정당화하는 응답 신호를 제공합니다. 삭제할 수 있습니다 자세한 내용은 워크플로 개요: 컨텍스트에 대해 유효성 검사 응답을 사용합니다.
일반적인 예: 수락
이 시나리오는 시스템이 동일한 메시지를 수락하는 주소를 확인할 수 있습니다.
| 주소 입력됨 | 지역 |
|---|---|
| 서울시 강남구 상상로123 456 | 영국 |
허용되는 주소에 대한 결과
아래 예에서는 중요한 신호를 강조 표시합니다.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
이외에도 응답은 다음을 나타냅니다.
hasUnconfirmedComponents는false로 남아 있음hasInferredComponents는false로 남아 있음hasReplacedComponents는false로 남아 있음
이러한 신호를 함께 사용하면 고품질 주소를 나타냅니다.
<ph type="x-smartling-placeholder">예외적인 케이스 예시: 수락
다음 예는 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입니다.
| 주소 입력됨 | 지역 |
|---|---|
| 서울특별시 강남구 테헤란로 152 강남파이낸스센터 22층 | 미국 |
확인되지 않은 번지에 대한 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 데이터
이 예는 모든 주소 구성요소가 포함된 미국 주소를 입력하는 방법을 보여줍니다.
추론되거나 교체된 구성요소가 없는 것으로, 그리고
총 PREMISE개 중 validationGranularity번째 계정입니다. 하지만 uspsData는
채워지고 dpvConfirmation 값을 포함하지 않습니다.
| 주소 입력됨 | 지역 |
|---|---|
| 서울특별시 강남구 테헤란로 152 강남파이낸스센터 22층 | 미국 |
불완전한 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"
}