모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps JavaScript API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps JavaScript API 및 관련 서비스 활성화
  3. 적합한 키 생성
계속

지도 현지화

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

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

언어 현지화

기본적으로 Google Maps JavaScript API는 지도 위에 컨트롤 이름, 저작권 고지, 자동차 길찾기, 레이블 등의 텍스트 정보를 표시할 때 브라우저에서 지정한 사용자의 기본 언어 설정을 사용합니다. 대부분의 경우 브라우저 설정을 사용하는 것이 좋습니다. 그러나 Maps JavaScript API가 브라우저의 언어 설정을 무시하도록 하려면 Maps JavaScript API 코드를 로드할 때 <script> 태그에 language 매개 변수를 추가하여 특정 언어로 정보를 표시하도록 할 수 있습니다.

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

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

예시 보기.

지도의 언어를 설정하는 경우 지역 설정도 고려해야 합니다. 이는 애플리케이션이 현지 법률을 준수하는 데 도움이 됩니다.

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

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

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

예시 보기.

지원되는 언어 목록을 참조하세요. 새로운 언어가 자주 추가되므로 이 목록은 완전하지 않을 수 있습니다.

지역 현지화

maps.googleapis.com에서 Google Maps JavaScript API를 로드하면 애플리케이션 동작의 기본 편중이 미국으로 적용됩니다. 애플리케이션이 다른 지도 타일을 제공하도록 변경하거나 애플리케이션을 편중하고 싶다면(예: 지오코딩 결과를 해당 지역으로 편중), Maps JavaScript API 코드를 로드할 때 region 매개변수를 <script> 태그에 추가하는 방식으로 이 기본 동작을 재정의할 수 있습니다.

애플리케이션이 호스팅되는 국가에 올바른 지역 현지화를 적용하여 애플리케이션이 현지 법률을 준수하게 하는 것은 Maps JavaScript API 애플리케이션 개발자의 책임입니다.

region 매개변수는 유니코드 지역 서브태그 식별자를 허용합니다. (일반적으로) 여기에는 국가 코드 최상위 수준 도메인(ccTLD)에 대한 1:1 매핑이 포함됩니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어, 영국의 ccTLD는 "uk"(도메인 .co.uk와 일치)이지만, 지역 식별자는 "GB"입니다.

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

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

다음 예시는 두 개의 지도를 보여줍니다. 하나는 기본 지역(미국)을 기준으로 "Toledo"를 "Toledo, Ohio"로 지오코딩하는 지도이고, 다른 하나는 ES(스페인)로 설정된 region을 기준으로 결과를 "Toledo, Spain"으로 편중하는 지도입니다.

US 예시ES 예시 보기.

중국에서 API 로드

Google Maps JavaScript API는 중국 내에서 http://maps.google.cn에서 제공됩니다. 중국에 콘텐츠를 제공할 때는 https://maps.googleapis.comhttp://maps.google.cn으로 교체합니다. 예:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

중국 사용자를 특별히 대상으로 하는 경우 지역과 언어 매개변수도 추가해야 합니다. 이 API는 language 매개변수의 값으로 zh-CNzh-TW를 모두 지원합니다.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

다음에 대한 의견 보내기...

Google Maps JavaScript API
Google Maps JavaScript API
도움이 필요하시나요? 지원 페이지를 방문하세요.