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 필드에서 사용하는 것과 동일한 주소 프로토를 사용합니다. 단, 다음 예외가 있습니다.
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는Calle Duenas가 됩니다. 여기서 ñ는 n으로 대체됩니다. - 주소의 현지 언어가 라틴어 기반 문자 집합을 사용하지 않고 주소 구성요소에 해당하는 영어가 없는 경우 서비스는 사용 가능한 경우 현지 언어의 라틴어화된 버전을 사용합니다.
예를 들어 일본어 전환은 일본어의 로마자 표기를 반환합니다.
영어가 아닌 라틴 문자는 영어 기반 라틴 문자로 대체됩니다. 예를 들어 ３丁目은 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)으로 이메일을 보내주세요.