Address Validation API는 응답 본문을 JSON으로 제공합니다. 객체입니다.
result
,ValidationResult
유형의 객체responseID
{
"result": {
// Validation verdict.
"verdict": {},
// Address details determined by the API.
"address": {},
// The geocode generated for the input address.
"geocode": {},
// Information indicating if the address is a business, residence, etc.
"metadata": {},
// Information about the address from the US Postal Service
// ("US" and "PR" addresses only).
"uspsData": {},
},
// A unique identifier generated for every request to the API.
"responseId": "ID"
}
이 문서에서는 result
객체에 중점을 둡니다. 자세한 내용은
responseID
에 관한 자세한 내용은 업데이트된 주소 처리를 참고하세요.
verdict
속성
verdict
속성은 주소 유효성 검사 결과를 요약하고
은 주소 확인 로직을 작성할 때 평가할 첫 번째 속성이어야 합니다.
이 속성은
출력 주소입니다. 예를 들어 다음은 verdict
속성을 보여줍니다.
이 특정 요청에 대해 4개의 필드를 반환합니다.
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
다음 섹션에서는 verdict
속성의 모든 필드를 요약합니다.
자세한 내용은 결과를 참조하세요. |
주소 세부사항
주소 세부사항은
또는 지오코드의 특이도
validationGranularity
응답은 주소 여부를 알 수 있는 주요 신호입니다
제공 가능합니다
verdict
속성은 다음과 같은 세부사항 신호를 반환합니다.
inputGranularity
: Address Validation API로 전송된 주소입니다 요청은 유효성 검사 응답의 주소 세부정보 수준에 영향을 미칩니다. 예를 들어 주소가PREMISE
보다inputGranularity
낮은 주소는 다음과 같습니다. 일반적으로validationGranularity
에서PREMISE
로 이어지지 않습니다. 있습니다.validationGranularity
: Address Validation API는 주소의 유효성을 완전히 검사할 수 있습니다. 대부분의 경우PREMISE
또는SUB_PREMISE
의 세부사항 수준은 품질 주소를 나타냅니다. 게재 가능한 광고 단위입니다.geocodeGranularity
: 지오코드의 세부정보 수준을 설명합니다. 확인할 수 있습니다. 예를 들어 Google 레코드는 정확한 위치는 아님 대형 아파트 단지 내의 특정 아파트입니다. 이 경우validationGranularity
이SUB_PREMISE
이지만geocodeGranularity
is
PREMISE`입니다.
자세한 내용은 세부사항 참조하세요. |
주소의 완전성
확인 결과는 addressComplete
속성을
고품질 주소가 필요하기 때문입니다. 즉, 누락되거나
해결되지 않았거나 예기치 않은 구성요소:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
주소에 누락되었거나 해결되지 않았거나 예상치 못한 구성요소가 있는 경우 필드
false
로 설정되어 있습니다.
아래에서 addressComplete 을(를) 참조하세요.
결과 및
참조 가이드의 주소를 확인하세요. |
주소 품질
가능한 여러 필드가 주소 구성요소의 문제 또는
주소 구성 요소나 누락된 주소 구성 요소를 비롯한 여러 가지 조정 문제를 해결해야 합니다. 대상
예를 들어 다음 verdict
속성은 확인되지 않은 주소를 나타냅니다.
구성요소 및 누락된 addressComplete
필드가 포함됩니다.
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true,
"hasInferredComponents": true
}
참조 가이드의 결과를 확인하세요. |
address
및 addressComponent
속성
address
속성은
다음을 포함한 주소 구성요소 수준의 요약과 함께
주소의 철자가 틀린 부분, 잘못된 부품을 교체하거나, 누락된 것으로 추정되는 부분
알 수 있습니다.
참조 가이드의 Address 를 참고하세요. |
addressComponent
속성은 address
의 하위 구성요소로,
주소가 지정된 주소 또는 구성 요소에 대한
Address Validation API가 처리되었습니다. API는 각 구성요소를 식별하고
필드는 이름, 유형, 확인 수준을 기준으로 제공됩니다.
참조 가이드의 addressComponent 를 참고하세요. |
geocode
속성
geocode
속성은 입력과 연결된 지오코딩된 위치를 나타냅니다.
있습니다. 이 속성은 위치 자체에 관한 세부정보를 제공합니다. 예를 들면 다음과 같습니다.
장소 ID입니다.
참조 가이드의 Geocode 를 참고하세요. |
metadata
속성
이 속성은 Address Validation API이지만 주소가 주거지 유형인지 여부를 나타냅니다. 비즈니스 또는 사서함
Address Validation API 범위 및 Address metadata 에 대한 참조를 확인하세요.
|
uspsData
속성
이 속성은 미국 우편 주소에 대한 유용한 정보를 제공합니다.
하지만 확인된 모든 주소에 완전히 채워지는 것은 아닙니다.
나타냅니다 따라서
주소를 검증하는 유일한 수단이지만 대신 verdict
및
address
도 지원합니다.
미국 주소 처리 및 UspsData 참조를 확인하세요.
|