기본 주소 확인 응답 이해

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이지만 geocodeGranularityisPREMISE`입니다.

주소의 완전성

확인 결과는 addressComplete 속성을 양질의 주소에 대한 신호로 반환합니다. 즉, 누락되거나 해결되지 않았거나 예상치 못한 구성요소가 없음을 의미합니다.

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

주소에 누락되었거나 해결되지 않았거나 예상치 못한 구성요소가 있는 경우 필드 false로 설정되어 있습니다.

주소 품질

가능한 여러 필드가 주소 구성요소의 문제 또는 주소 구성 요소나 누락된 주소 구성 요소를 비롯한 여러 가지 조정 문제를 해결해야 합니다. 예를 들어 다음 verdict 속성은 확인되지 않은 구성요소가 있고 addressComplete 필드가 누락된 주소를 나타냅니다.

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}

address 및 addressComponent 속성

address 속성은 요청에 제공된 처리된 주소의 형식을 제공하고, 주소의 잘못된 부분, 잘못된 부분이 대체된 부분, 누락된 부분이 추론된 부분을 비롯한 주소의 구성요소 수준 요약을 제공합니다.

addressComponent 속성은 address의 하위 구성요소로, 주소가 지정된 주소 또는 구성 요소에 대한 Address Validation API가 처리되었습니다. API는 이름, 유형, 확인 수준을 기준으로 각 구성요소 필드를 식별합니다.

geocode 속성

geocode 속성은 입력 주소와 연결된 지오코딩된 위치를 나타냅니다. 이 속성은 장소 ID와 같은 위치 자체에 관한 세부정보를 제공합니다.

metadata 속성

이 속성은 Address Validation API에서 처리하는 모든 주소에 채워지지 않을 수 있지만 주소가 거주지, 비즈니스 또는 사서함 유형인지 나타냅니다.

uspsData 속성

이 속성은 미국 우편 주소에 대한 유용한 정보를 제공합니다. 하지만 서비스에서 확인한 모든 주소에 대해 완전히 채워지는 것은 아닙니다. 따라서 주소를 검증하는 유일한 수단이지만 대신 verdict 및 address도 지원합니다.