Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

주소 확인 - 예시

이 문서에서는 Address Validation API가 시스템의 확인 동작을 보장하는 주소에 응답 신호를 제공하는 여러 실제 시나리오를 설명합니다. 여기에 있는 예는 설명용이며 완전하지는 않습니다. 컨텍스트는 검증 로직 빌드 의 워크플로 개요를 참고하세요.

일반적인 예: 확인

다음 예는 비슷한 거리 이름이 있는 대도시 지역의 사례를 보여줍니다. 사용자가 미국 워싱턴주 커클랜드의 Google Building D 의 주소를 입력하려고 한다고 가정해 보겠습니다. 하지만 도시로 커클랜드 대신 실수로 시애틀 을 입력합니다.

입력된 주소	지역
Building D, 451 7th Avenue South, Seattle, WA 98033	미국

대체된 데이터의 결과

아래 예에서는 결과의 중요한 신호를 강조합니다.

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

PREMISE_PROXIMITY 세분화 수준은 건물 수준 주소의 근사치를 나타내지만 입력에 제공된 세분화인 SUB_PREMISE만큼 세부적이지는 않습니다. 응답에는 확인되지 않은 구성요소와 대체된 구성요소가 모두 포함되어 있으므로 조합하면 확인 카테고리로 이동합니다.

주소 구성요소를 쿼리하면 다음과 같은 우려사항이 드러납니다.

{
  "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는 제공된 주소 시애틀에 가까운 근사치를 찾았고, 상위 구성요소인 우편번호를 시애틀 주소로 해결하기 위해 대체했습니다. 이는 유효한 대체일 수 있지만 구성요소가 확인되지 않았다는 사실과 함께 사용자가 커클랜드와 같은 다른 주소가 아닌 시애틀 주소를 입력하려고 하는지 확인하는 것이 좋습니다.

특이한 사례 예: 확인

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

확인된 사소한 추론. Address Validation API는 국가, 우편번호 또는 주를 추론하지만 그 외의 모든 항목은 제공되고 확인됩니다. 세분화 수준과 확인 수준의 조합으로 인해 확인 작업이 필요하지 않은 사소한 추론이 발생합니다.
확인되지 않은 예기치 않은 주소 구성요소. 확인되지 않은 주소 구성요소는 주소의 위험 수준을 높입니다. 확인이 필요할 수 있습니다.
확인된 예기치 않은 주소 구성요소. 구성요소는 올바른 주소에 엄격하게 필요한 것은 아니며 Address Validation API는 출력에서 이를 삭제합니다. 일반적으로 형식 지정 문제에는 확인이 필요하지 않습니다.

확인된 사소한 추론

더 세분화된 수준의 확인된 데이터와 결합하면 입력에 다음 유형의 구성요소 중 하나만 누락된 경우에도 API는 올바른 추론을 내릴 수 있습니다.

도시
주
우편번호
국가

예를 들어 고객이 매사추세츠주 스프링필드의 McDonald's 레스토랑에 유효한 거리 주소를 제공하지만 도시를 입력하는 것을 잊고 4자리 확장자가 없는 우편번호를 제공합니다.

입력된 주소	지역
1402 Allen St, MA 01118	미국

누락된 도시의 결과

{
  "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 및 영국 및 국제 우편 주소 지정 방법을 참고하세요.

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

입력된 주소	지역
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	영국

확인된 예기치 않은 주소 구성요소의 결과

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

여기서 address_complete는 false로 평가되고 주소 구성요소 분석을 통해 예기치 않은 플래그가 드러납니다.

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

글로스터셔는 입력된 주소의 올바른 카운티이지만 주소 자체의 형식이 잘못되었습니다. Address Validation API는 올바른 형식 지정을 위한 정보도 평가합니다.