Address Validation API를 사용할 때는 검증 응답에서 영어로 변환된 주소도 반환하도록 요청할 수 있습니다. 시스템이 영어가 아닌 언어로 된 주소를 수신할 때 영어 기반 라틴 문자로 주소 정보를 제공해야 하는 경우 이 기능을 사용하세요. 예를 들면 다음과 같습니다.
- 귀사는 전 세계에서 접수된 배송 요청을 처리하고 영어 및 영어 기반 라틴 문자를 사용하여 모든 주소를 표준화할 수 있습니다.
- 비즈니스에서 제공된 주소의 언어와 다른 언어를 사용하는 국가의 발송 및 수입을 처리할 수 있습니다.
영어로 주소를 반환하는 방법
영어 등가 구성요소가 포함된 주소 검증을 요청하려면 검증 요청 본문에 다음을 추가합니다.
"languageOptions": { "returnEnglishLatinAddress": "true" }
다음 예에서는 프라도 박물관의 주소를 확인하는 동안 영어 기반 구성요소를 요청합니다.
curl -X POST -d '{ "address": { "region_code" : "ES", "address_lines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"], }, "languageOptions": {returnEnglishLatinAddress: true} }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: API_KEY' \ 'https://addressvalidation.googleapis.com/v1:validateAddress'
응답은 englishLatinAddress
필드에 영어 주소를 반환합니다. 자세한 내용은 아래의 주소 변환 예를 참고하세요. 반환된 현지 언어 주소의 각 구성요소는 최대한 영어로 변환됩니다. 변환된 주소는 API의 입력으로 재사용할 수 없습니다.
englishLatinAddress
필드는 address
필드와 동일한 Address 프로토를 사용합니다. 단, 다음 예외가 있습니다.
ConfirmationLevel
필드 없음unconfirmedComponentTypes
필드 없음
주소 변환의 작동 방식
Address Validation API는 주소의 각 구성요소에 영어 변환을 적용합니다. 즉, 주소의 administrative_area
, locality
, 기타 구성요소가 개별적으로 처리됩니다. 주소 구성요소 목록은 참조 문서의 AddressComponent를 참고하세요.
다음 다이어그램은 주소 Calle Dueñas, 5, 41003 Sevilla, España의 영어 변환이 어떻게 표시되는지 보여줍니다.
영어로 변환하기 위해 평가되는 각 구성요소에 대해 서비스는 다음 섹션에 설명된 프로세스를 사용합니다.
가능한 경우 완전히 번역된 영어 사용
일부 주소 구성요소에는 완전히 번역된 버전을 사용할 수 있습니다.
예를 들어 스페인 국가 España
은 Spain
로 번역됩니다. 이 경우 서비스는 영어 버전을 사용합니다. 이는 일반적으로 country
및 administrative_area_level_1
과 같은 더 큰 주소 구성요소에 해당합니다.
영어를 사용할 수 없는 경우 현지 언어의 라틴어화를 사용합니다.
라틴어 변환은 텍스트 변환을 사용하여 현지 언어를 라틴어 스크립트로 변환하는 것을 의미합니다.
- 주소의 현지 언어가 라틴 문자 집합을 사용하고 주소 구성요소에 영어 등가 항목이 없는 경우 서비스는 영어 기반이 아닌 현지 언어의 문자를 대체합니다.
예를 들어
Calle Dueñas
는 ñ이 n으로 대체된Calle Duenas
가 됩니다. - 주소의 현지 언어가 라틴 기반 문자 집합을 사용하지 않고 주소 구성요소에 상응하는 영어가 없는 경우 서비스는 현지 언어의 라틴화 버전을 사용합니다(있는 경우).
예를 들어 일본어 변환은 일본어의 로마자 표기를 반환합니다.
영어가 아닌 라틴어가 아닌 문자는 영어 기반 라틴 문자로 대체됩니다. 예를 들어 3丁目는 3-chome이 됩니다.
- 미리보기에서는 아직 일본어가 사용 설정되지 않았습니다.
- 라틴어 버전의 언어를 사용할 수 없는 경우 구성요소가 현지 언어로 반환됩니다.
영어가 아닌 라틴 문자를 대체합니다.
영어가 아닌 라틴 문자는 영어 문자로 대체됩니다. 예를 들어 다음 문자 각각은 'o' 문자로 대체됩니다. ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ, ợ 예를 들면 다음과 같습니다.
Calle de Ruiz de Alarcón이 Calle de Ruiz de Alarcon으로 변경됨
주소 변환 예시
다음 예는 스페인의 Palacio de las Dueñas 요청에 대한 유효성 검사 응답을 보여줍니다. englishLatinAddress
가 굵게 표시되어 있습니다. 이 요청은 입력의 languageOptions
매개변수에 있는 returnEnglishLatinAddress
필드를 사용했습니다.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
미리보기 출시 지원 옵션
Google은 서비스의 미리보기 버전, 기능에 대한 지원을 제공하지 않지만 이러한 개발 단계에서 접수된 요청은 사례별로 지원 여부가 고려됩니다.
GA 이전 버전에는 다음 권장사항을 사용하세요.
GA 이전 버전 기능에는 Google Maps Platform SLA가 적용되지 않습니다.
특히 프로덕션 환경에서 GA 이전 기능을 사용하는 경우 대체 메커니즘을 사용하세요. 대체 상황의 예는 할당량 초과, 예상치 못한 응답 코드 및 지연 시간, 기존 동작과 비교할 때 예상치 못한 응답입니다.
Issue Tracker를 사용하여 새 기능을 요청하거나 기존 기능의 수정사항을 제안할 수 있습니다. 요청에는 다음을 포함하세요.
추가하고 싶은 구체적인 기능이나 동작과 그 기능이 중요하다고 생각되는 이유를 설명하세요.
가능한 경우 사용 사례에 대한 구체적인 설명과 해당 기능의 이점을 포함하세요.
이 의견 또는 기능에 관한 다른 질문이 있으면 주소 유효성 검사 핫라인(address-validation-hotline@google.com)으로 이메일을 보내주세요.