이 페이지는 Cloud Translation API를 통해 번역되었습니다.

주소 확인 - 예시

이 문서에서는 Address Validation API가 시스템에서 확인 동작을 요하는 주소에 대한 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 관련 내용은 유효성 검사 로직 빌드의 워크플로 개요를 참고하세요.

일반적인 예: 확인

다음 예는 거리 이름이 유사한 대도시 지역의 사례를 보여줍니다. 사용자가 미국 워싱턴주 커클랜드에 있는 Google 건물 D의 주소를 입력하려고 한다고 가정해 보겠습니다. 하지만 이 도시 대신 커클랜드가 아닌 시애틀에 의도치 않게 진입했습니다.

주소 입력됨	지역
건물 D, 451 7th Avenue South, Seattle, WA 98033	US

대체된 데이터에 대한 결과

아래 예에서는 응답에서 중요한 신호를 강조합니다.

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

PREMISE_PROXIMITY은 건물 수준 주소의 근접을 나타내지만 입력 시 제공되는 세부사항인 SUB_PREMISE만큼 상세하지는 않습니다. 응답에는 확인되지 않은 구성요소와 교체된 구성요소도 모두 포함되므로 조합은 이를 confirm 카테고리에 반영합니다.

주소 구성요소를 쿼리하면 다음과 같은 우려 사항이 표시됩니다.

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

이 경우 Address Validation API는 시애틀에서 제공된 주소와 매우 흡사한 주소를 찾아 더 높은 수준의 구성요소인 우편번호를 대체하여 시애틀 주소를 확인합니다. 이 주소는 유효한 대체 주소일 수 있지만 구성요소가 확인되지 않았다는 사실과 함께 사용자가 Kirkland와 같은 다른 주소가 아닌 시애틀 주소를 입력하도록 하는 것이 좋습니다.

예외적인 케이스 예시: 확인

다음 예는 다음과 같은 특이 사례 유형을 보여줍니다.

확인된 사소한 추론. Address Validation API는 국가, 우편번호 또는 주/도를 유추하지만 그 밖의 정보는 모두 제공되고 확인됩니다. 세부사항과 확인 수준을 모두 함께 사용하면 확인 작업이 필요하지 않은 사소한 추론이 가능합니다.
예상치 못한 주소 구성요소가 확인되지 않음. 확인되지 않은 주소 구성요소는 주소의 위험 수준에 추가됩니다. 이를 통해 확인이 필요할 수 있습니다.
예상치 못한 주소 구성요소가 확인되었습니다. 구성요소는 올바른 주소를 반드시 필요로 하지 않으며 Address Validation API는 출력에서 이를 삭제합니다. 형식 문제는 일반적으로 확인을 보증하지 않습니다.

확인된 사소한 추론

보다 세부적인 수준의 확인된 데이터와 결합하면 입력에 다음 유형의 구성요소 중 하나만 누락된 경우 API가 올바른 추론을 수행할 수 있습니다.

도시
상태
우편번호
국가

예를 들어 고객이 매사추세츠 스프링필드에 있는 맥도날드 식당의 상세 주소를 제공했지만 도시를 입력하지 않고 4자리 확장자 없이 우편번호를 제공한 경우입니다.

주소 입력됨	지역
서울특별시 강남구 테헤란로 152	US

도시 누락에 대한 판결

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

Address Validation API가 배송 가능한 주소를 생성하기 위해 상위 수준의 구성요소를 추론하는 경우 시스템의 데이터가 정확하다고 확신할 수 있습니다. 이는 광범위한 지역을 나타내는 추론된 구성요소가 더 세분화된 확인된 주소 구성요소에 더 쉽게 일치하기 때문입니다. 미국의 스프링필드와 같이 도시 이름이 반복되는 국가에서도 다른 구성요소를 함께 사용하여 고유한 주소를 제공할 수 있습니다.

위의 예를 보면 모든 주소 구성요소를 스캔하면 모든 구성요소가 확인되었음을 알 수 있습니다. 즉, Address Validation API에 저장된 데이터와 일치하며 서비스는 상위 구성요소 두 개도 추론합니다.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

예기치 않은 주소 구성요소가 확인되지 않음

이 시나리오는 구성요소가 확인되지 않은 경우 확인의 중요성을 보여줍니다. 주소 구성요소가 예기치 않은 경우 Address Validation API는 출력에서 주소를 삭제합니다. 이 경우 위험 수준과 신뢰 수준에 따라 주소를 수락하거나 고객에게 다시 확인할 수 있습니다.

예를 들어 우편 당국에서 무시하는 무해한 정보를 고객이 자주 입력하는 지역의 주소일 수 있으며, 이 경우 주소를 수락합니다. 하지만 경우에 따라 확인되지 않은 구성요소가 고객이 원하는 것이 아닐 수도 있습니다.

주소 입력됨	지역
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry	프��

예상치 못한 주소 구성요소에 대한 결과가 확인되지 않음

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

Address Validation API는 확인되지 않은 구성요소가 포함된 결과 외에도 다음과 같은 형식의 주소를 반환합니다.

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

확인되지 않은 구성요소를 스캔하면 API가 반환된 주소에서 la caritat 2를 삭제했음을 알 수 있습니다.

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

확인된 예상치 못한 주소 구성요소

이 예는 제공된 주소에 영국 카운티가 포함된 것을 보여주며 이는 일반적인 방법입니다. 그러나 이는 영국 우편 기관에서 요구하는 것이 아니며 기본적으로 무시됩니다. postoffice.co.uk 및 영국 및 국제 우편 주소 처리 방법을 참조하세요.

따라서 고객이 영국 주소의 카운티를 제공하면 서비스는 이를 예상치 못한 입력으로 평가합니다.

주소 입력됨	지역
서울시 강남구 상상로123 456	UK

확인된 예상치 못한 주소 구성요소에 대한 결과

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

여기서 address_complete는 false로 평가되고 주소 구성요소를 분석하면 예기치 않은 플래그가 나타납니다.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

입력한 주소의 카운티는 글로스터셔(Gloucestershire)이지만, 주소 자체의 형식이 잘못되었습니다. Address Validation API는 정보가 적절한 형식인지도 평가한다는 점을 기억하세요