지도 현지화

다음과 같은 방법으로 특정 국가 또는 지역의 지도를 맞춤설정할 수 있습니다.

  • 기본 언어 설정을 변경합니다.
  • 지정된 국가 또는 지역을 기반으로 지도의 동작을 변경하는 지역 코드를 지정합니다.

언어 현지화

기본적으로 Maps JavaScript API는 지도에 컨트롤 이름, 저작권 고지, 운전 경로, 라벨 등의 텍스트 정보를 표시할 때 브라우저에 지정된 사용자의 기본 언어 설정을 사용합니다. 대부분의 경우 브라우저 설정을 따르는 것이 좋습니다. 하지만 Maps JavaScript API에서 브라우저의 언어 설정을 무시하도록 하려면 Maps JavaScript API 코드를 로드할 때 language 매개변수를 <script> 태그에 추가하여 정보를 특정 언어로 표시하면 됩니다.

language 매개변수는 컨트롤의 이름, 저작권 고지, 운전 경로, 컨트롤 라벨 및 서비스 요청에 대한 응답에 영향을 미칩니다. 서비스에 미치는 영향은 명확하지 않습니다. 예를 들어 거리 수준 주소를 지오코딩할 때 국가 이름은 요청한 언어로 반환되지만 나머지 주소는 지오코딩하는 위치에 따라 달라집니다. 반면 우편 및 정치적 결과는 요청된 언어로 반환됩니다. 이 데모를 사용하여 language 매개변수를 업데이트하면 지도가 어떻게 변경되는지 확인해 보세요.

다음 예에서는 일본어로 지도를 표시하고 지역을 일본으로 설정합니다.

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=JP&language=ja&callback=initMap">
</script>

예 보기

지도의 언어를 설정하는 경우 지역 설정도 고려해야 합니다. 이렇게 하면 애플리케이션이 현지 법률을 준수하도록 할 수 있습니다.

참고: 위에 표시된 방식으로 API를 로드하면 사용자 환경설정과 관계없이 모든 사용자에게 지도가 일본어로 표시됩니다. 이 옵션을 설정하기 전에 이 동작을 원하는지 확인하세요.

또한 Maps JavaScript API는 기본적으로 왼쪽에서 오른쪽 방향(LTR), 오른쪽에서 왼쪽 방향(RTL) 언어의 문자가 모두 포함된 양방향(Bidi) 텍스트를 지원합니다. RTL 언어의 예로는 아랍어, 히브리어, 페르시아어가 있습니다. 일반적으로 올바르게 렌더링하려면 페이지의 <html> 요소에 dir='rtl'을 추가하여 RTL 언어 페이지를 지정해야 합니다. 다음 예에서는 아랍어 컨트롤을 사용하여 이집트 카이로의 지도를 렌더링합니다.

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=EG&language=ar&callback=initMap">
</script>

예 보기

지원되는 언어의 목록을 참고하세요. 새로운 언어가 자주 추가되므로 이 목록에 모든 언어가 포함되지 않을 수도 있습니다.

지역 현지화

다른 지도 타일을 제공하도록 애플리케이션을 변경하거나 애플리케이션을 편중(예: 지오코딩 결과를 해당 지역으로 편중)하고 싶다면 Maps JavaScript API 코드를 로드할 때 region 매개변수를 <script> 태그에 추가합니다.

Maps JavaScript API 애플리케이션의 개발자는 region을 설정하면 다양한 서비스(예: Places Autocomplete)에서 더 나은 결과를 제공하는 경향이 있으므로 ,항상 region 매개변수를 설정하는 것이 좋습니다. 또한 애플리케이션이 호스팅되는 국가에 올바른 지역 현지화가 적용되는지 확인하여 해당 애플리케이션이 현지 법률을 준수하는지 확인할 책임이 있습니다.

region 매개변수는 일반적으로 국가 코드 최상위 도메인(ccTLD)에 일대일로 매핑되는 유니코드 지역 하위 태그 식별자를 허용합니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 alpha-2 코드와 동일하지만 일부 주목할 만한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(도메인 .co.uk에 해당)이지만 지역 식별자는 'GB'입니다. 지원되는 지역은 Google Maps Platform 노출 범위 세부정보를 참고하세요. 이 데모를 사용하여 region 매개변수를 업데이트하면 지도가 어떻게 변경되는지 확인해 보세요.

예를 들어 다음 script 태그는 지도를 영국 기준으로 현지화합니다.

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB&callback=initMap">
</script>

다음 예는 US(미국)로 설정된 region을 기반으로 'Toledo'를 '오하이오주 톨레도'로 지오코딩하는 지도와 ES(스페인)로 설정된 region을 기반으로 결과를 '스페인 똘레도'로 편중하는 지도를 보여줍니다.

미국 예스페인 예를 확인하세요.

현지화 데모

지도의 언어를 설정하는 경우 지역 설정도 고려해야 합니다. 다음은 지도를 원하는 언어 및 지역으로 로드할 수 있는 데모입니다.

전체 화면에서 이 데모를 확인하세요.