JavaScript [구글지도] 설정된 나라로 현지화 하기
페이지 정보
본문
현지화
기본 언어 설정을 변경하거나 애플리케이션의 지역 코드를 설정하는 방식으로 Maps API 애플리케이션을 현지화할 수 있습니다. 그러면 지정된 국가나 영토에 따라 작동 방식이 변경됩니다.
언어 현지화
Google Maps API는 지도 위에 컨트롤 이름, 저작권 고지, 자동차 길찾기, 레이블 등의 텍스트 정보를 표시할 때 브라우저의 선호 언어를 사용합니다. 대부분의 경우 이 방법이 선호됩니다. 대개 사용자의 선호 언어 설정을 재정의하지 않는 것이 좋습니다. 그러나 Maps API가 브라우저 언어 설정을 무시하고 강제로 특정 언어로 정보를 표시하게 하고 싶다면, Maps API JavaScript 코드를 포함할 때 선택적 language 매개변수를 <script> 태그에 추가하여 사용할 언어를 지정할 수 있습니다.
예를 들어, 영어로 Maps API 애플리케이션을 표시하려면 아래와 같이 &language=en를 <script> 태그에 추가합니다.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=en" type="text/javascript"></script>
일본어 : language=ja
지역 현지화
maps.googleapis.com에서 Maps API를 로드하면 애플리케이션 동작의 기본 편중이 미국으로 적용됩니다. 애플리케이션이 다른 지도 타일을 제공하도록 변경하거나 애플리케이션을 편중하고 싶다면(예: 지오코딩 결과를 해당 지역으로 편중), Maps API JavaScript 코드를 포함할 때 region 매개변수를 <script> 태그에 추가하는 방식으로 이 기본 동작을 재정의할 수 있습니다.
애플리케이션이 호스팅되는 국가에 올바른 지역 현지화를 적용하여 애플리케이션이 현지 법률을 준수하게 하는 것은 Maps API 애플리케이션 개발자의 책임입니다.
region 매개변수는 유니코드 지역 서브태그 식별자를 허용합니다. (일반적으로) 여기에는 국가 코드 최상위 수준 도메인(ccTLD)에 대한 1:1 매핑이 포함됩니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어, 영국의 ccTLD는 "uk"(도메인 .co.uk와 일치)이지만, 지역 식별자는 "GB"입니다.
예를 들어, 영국으로 현지화된 Maps API 애플리케이션을 사용하려면 아래와 같이 ®ion=GB를 <script> 태그에 추가합니다.
중국에서 API 로드
Google Maps API는 중국에서는 http://maps.google.cn에서 제공됩니다. 중국에 콘텐츠를 제공할 때는 https://maps.googleapis.com 을 http://maps.google.cn으로 교체합니다. 예:
<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY" type="text/javascript"></script>
중국 사용자를 특별히 대상으로 하는 경우, 지역과 언어 매개변수도 추가할 수 있습니다. 이 API는 language 매개변수의 값으로 zh-CN과 zh-TW를 모두 지원합니다.
<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY" type="text/javascript"></script>
관련자료
https://developers.google.com/maps/documentation/javascript/basics?hl=ko#Localization
기본 언어 설정을 변경하거나 애플리케이션의 지역 코드를 설정하는 방식으로 Maps API 애플리케이션을 현지화할 수 있습니다. 그러면 지정된 국가나 영토에 따라 작동 방식이 변경됩니다.
언어 현지화
Google Maps API는 지도 위에 컨트롤 이름, 저작권 고지, 자동차 길찾기, 레이블 등의 텍스트 정보를 표시할 때 브라우저의 선호 언어를 사용합니다. 대부분의 경우 이 방법이 선호됩니다. 대개 사용자의 선호 언어 설정을 재정의하지 않는 것이 좋습니다. 그러나 Maps API가 브라우저 언어 설정을 무시하고 강제로 특정 언어로 정보를 표시하게 하고 싶다면, Maps API JavaScript 코드를 포함할 때 선택적 language 매개변수를 <script> 태그에 추가하여 사용할 언어를 지정할 수 있습니다.
예를 들어, 영어로 Maps API 애플리케이션을 표시하려면 아래와 같이 &language=en를 <script> 태그에 추가합니다.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=en" type="text/javascript"></script>
일본어 : language=ja
지역 현지화
maps.googleapis.com에서 Maps API를 로드하면 애플리케이션 동작의 기본 편중이 미국으로 적용됩니다. 애플리케이션이 다른 지도 타일을 제공하도록 변경하거나 애플리케이션을 편중하고 싶다면(예: 지오코딩 결과를 해당 지역으로 편중), Maps API JavaScript 코드를 포함할 때 region 매개변수를 <script> 태그에 추가하는 방식으로 이 기본 동작을 재정의할 수 있습니다.
애플리케이션이 호스팅되는 국가에 올바른 지역 현지화를 적용하여 애플리케이션이 현지 법률을 준수하게 하는 것은 Maps API 애플리케이션 개발자의 책임입니다.
region 매개변수는 유니코드 지역 서브태그 식별자를 허용합니다. (일반적으로) 여기에는 국가 코드 최상위 수준 도메인(ccTLD)에 대한 1:1 매핑이 포함됩니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어, 영국의 ccTLD는 "uk"(도메인 .co.uk와 일치)이지만, 지역 식별자는 "GB"입니다.
예를 들어, 영국으로 현지화된 Maps API 애플리케이션을 사용하려면 아래와 같이 ®ion=GB를 <script> 태그에 추가합니다.
중국에서 API 로드
Google Maps API는 중국에서는 http://maps.google.cn에서 제공됩니다. 중국에 콘텐츠를 제공할 때는 https://maps.googleapis.com 을 http://maps.google.cn으로 교체합니다. 예:
<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY" type="text/javascript"></script>
중국 사용자를 특별히 대상으로 하는 경우, 지역과 언어 매개변수도 추가할 수 있습니다. 이 API는 language 매개변수의 값으로 zh-CN과 zh-TW를 모두 지원합니다.
<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY" type="text/javascript"></script>
관련자료
https://developers.google.com/maps/documentation/javascript/basics?hl=ko#Localization
댓글목록
등록된 댓글이 없습니다.