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 필드는
주소
proto를 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으로 대체됩니다. - 주소의 현지 언어가 라틴어 기반 문자를 사용하지 않는 경우
주소 구성요소에 해당하는 영어가 없는 경우
가능한 경우 서비스는 현지 언어의 라틴어 버전을 사용합니다.
예를 들어 일본어 변환은 일본어의 로마자 표기를 반환합니다.
영어 및 라틴어가 아닌 문자는 모두 영어 기반 문자로 대체됩니다.
라틴 문자 예: 3STRING즉 3-chome이 됩니다.
- 미리보기에서는 아직 일본어가 지원되지 않습니다.
- 라틴어 버전의 언어를 사용할 수 없는 경우 구성요소가 현지 언어로 반환됩니다.
영어가 아닌 라틴 문자를 대체함
영어가 아닌 라틴 문자는 모두 영문자로 대체됩니다. 상응 대상입니다. 예를 들어 다음 각 문자는 문자 'o': 귀, ổ, ỗ, ỗ, ỡ,  , ở, ỡ 및 보내주시기 바랍니다. 예를 들면 다음과 같습니다.
Calle de Ruiz de Alarcón은 Calle de Ruiz de Alarcon이 됩니다.
주소 전환 예시
다음 예는 팔라시오에 대한 요청의 유효성 검사 응답을 보여줍니다.
de las Duetas를 위한 스페인어로, 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은 비록 구독이나 후원에 대해 미리보기 버전 Google은 이러한 요청을 고려합니다. 문제 해결 단계를 안내할 수 있습니다
GA 이전 버전에서는 다음 권장사항을 따르세요.
GA 이전 기능은 Google Maps Platform SLA.
대체 메커니즘을 사용합니다. 특히 GA 이전 기능을 추가하는 것입니다. 대체 예시 할당량 초과, 예기치 않은 응답 코드 및 지연 시간 예상하지 못한 반응이 나올 수도 있습니다.
Issue Tracker를 사용하여 새 기능을 요청하거나 수정사항을 제안할 수 있습니다. 추가할 수 있습니다 요청에 다음 정보를 포함해야 합니다.
추가되었으면 하는 특정 기능이나 동작을 설명해 주세요. 그것이 중요하다고 생각하는 이유이기도 합니다.
가능한 경우 사용 사례와 새로운 기회가 있을 수 있습니다.
기능에 대해 이 의견이나 기타 질문이 있으면 Address Validation Hotline: address-validation-hotline@google.com.