Address Validation API를 사용하면 유효성 검사 응답이 영어로 변환된 주소도 반환하도록 요청할 수 있습니다. 시스템이 영어가 아닌 언어로 된 주소를 수신할 때 영어 기반의 라틴 문자로 주소 정보를 제공해야 하는 경우 이 기능을 사용하세요. 예를 들면 다음과 같습니다.
- 회사는 전 세계 배송 요청을 처리하고 영어 및 영어 기반의 라틴 문자를 사용하여 모든 주소를 표준화할 수 있습니다.
- 비즈니스에서 제공된 주소의 언어와 다른 언어를 사용하는 국가로의 배송을 처리할 수도 있습니다.
영어로 주소 반품하는 방법
영어와 동등한 구성요소를 포함하여 주소 확인을 요청하려면 유효성 검사 요청 본문에 다음을 추가합니다.
languageOptions: { returnEnglishLatinAddress: "true" }.
다음 예에서는 프라도 미술관의 주소를 확인하면서 영어 기반 구성요소를 요청합니다.
curl -X POST -d '{
"regionCode" : ["ES"],
"addressLines": ["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 필드에서 사용하는 것과 동일한 주소 proto를 사용하지만 다음과 같은 예외가 있습니다.
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으로 대체합니다. - 주소의 현지 언어가 라틴어 기반 문자 집합을 사용하지 않고 주소 구성요소에 해당하는 영어 버전이 없는 경우, 가능한 경우 현지 언어의 라틴어 버전이 사용됩니다.
예를 들어 일본어 변환은 일본어의 로마자 표기를 반환합니다.
영어 및 라틴어가 아닌 문자는 영어 기반의 라틴 문자로 대체됩니다. 예: 3speech즉 3-chome이 됩니다.
- 미리보기에서는 아직 일본어가 지원되지 않습니다.
- 라틴어 버전의 언어를 사용할 수 없는 경우 구성요소가 현지 언어로 반환됩니다.
영어가 아닌 라틴 문자를 대체함
영어가 아닌 라틴 문자는 모두 영문자로 대체됩니다. 예를 들어 다음 문자는 각각 'o', Ờ, ó, CharacterStyle, õ, ö, ø, oh, 보도록, 회원, 모, ṍ, ṏ, ṑ, ṓ, help, Ng, ó, 최소화, ổ, ṟ, ., 게재됩니다, ổ, ỗ, . 예를 들면 다음과 같습니다.
Calle de Ruiz de Alarcón은 Calle de Ruiz de Alarcon이 됩니다.
주소 전환 예시
다음 예는 스페인의 팔라시오 데 라스 두에냐스에 대한 요청의 유효성 검사 응답(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)으로 이메일을 보내주세요.