지도 현지화

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

언어 현지화

기본적으로 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 코드를 로드할 때 애플리케이션이 다른 지도 타일을 제공하도록 변경하거나 애플리케이션을 편향 (예: 지오코딩 결과를 지역별로 편중)하려면 <script> 태그에 region 매개변수를 추가합니다.

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

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

예를 들어 다음 스크립트 태그는 지도를 영국에 현지화합니다.

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

다음 예는 두 개의 지도를 보여줍니다. 첫 번째는 'Toledo'를 US(US)로 설정하여 지오코딩한 region을 바탕으로, 오하이오주 톨레도(Toledo)로 설정된 region에 따라 ES(스페인)로 설정된 region에 따라 결과를 편향하는 지도입니다.

미국 예시ES 예시 보기

현지화 데모

지도의 언어를 설정할 때는 지역을 설정하는 것이 중요합니다. 다음은 선택한 언어 및 지역과 함께 지도를 로드할 수 있는 데모입니다.

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