지도 ID 사용하기

지도 ID는 Google Cloud Console에서 만들어 스타일과 연결한 후 앱 코드에 입력하여 지도에 스타일을 적용하는 식별자입니다.

지도 ID를 만들면 특정 프로젝트와 연결되며, 단일 플랫폼(Android, iOS, 자바스크립트) 또는 Maps Static API로 제한됩니다.

Cloud Console에서 지도 ID를 만들거나 관리하려면 프로젝트 소유자 또는 프로젝트 편집자 IAM 역할이 있어야 합니다.

지도 ID 만들기

지도 ID는 Google 지도의 단일 인스턴스를 나타내는 고유 식별자입니다. Cloud Console에서 언제든지 지도 ID를 만들고 지도 ID와 연결된 스타일을 업데이트할 수 있습니다.

지도 ID를 만들려면 다음 단계를 따르세요.

Cloud Console에서 지도 관리 페이지로 이동합니다.
새 지도 ID 만들기를 선택하여 새 지도 ID 만들기 양식을 표시합니다.

양식에서 다음 작업을 처리합니다.
- 지도 이름을 지정합니다.
- 지도 유형 또는 플랫폼을 지정합니다.
- 자바스크립트 지도의 경우 래스터 또는 벡터 지도 유형을 선택합니다.
- 지도에 대한 설명을 입력합니다.
- 다음을 선택하여 새 지도 ID를 표시합니다.

지도 ID를 지도 스타일에 연결하기

이 안내에서는 프로젝트에 기존 지도 스타일이 하나 이상 있다고 가정합니다.

Cloud Console에서 지도 관리 페이지로 이동합니다.
이 페이지의 지도 이름 열에서 기존 지도 ID를 선택합니다.
이 양식의 하단에 있는 이 지도 ID와 연결된 지도 스타일 드롭다운에서 지도 스타일을 선택합니다.
저장을 선택합니다.

앱에 지도 ID 추가하기

MapView 클래스를 사용하거나 프로그래매틱 방식으로 GoogleMapOptions 클래스를 사용하여 활동의 레이아웃 파일에 있는 <fragment> 요소를 통해 지도 ID를 추가합니다.

예를 들어 res/values/strings.xml에 map_id라는 문자열 값으로 저장된 지도 ID를 만들었다고 가정해 보겠습니다.

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

활동의 레이아웃 파일에 있는 <fragment> 요소를 통해 추가된 지도의 경우, 맞춤 스타일이 있어야 하는 모든 지도 프래그먼트에서 지도 ID를 map:mapId 속성에 지정해야 합니다.

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

MapView 클래스의 map:mapId 속성을 사용하여 지도 ID를 지정할 수도 있습니다.

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

프로그래매틱 방식으로 지도 ID를 지정하려면 GoogleMapOptions 클래스를 사용하여 지도 ID를 MapFragment 인스턴스에 전달합니다.

자바

  MapFragment mapFragment = MapFragment.newInstance(
      new GoogleMapOptions()
          .mapId(getResources().getString(R.string.map_id)));

Kotlin

  val mapFragment = MapFragment.newInstance(
      GoogleMapOptions()
          .mapId(resources.getString(R.string.map_id))
  )

Android 스튜디오에서 평상시처럼 앱을 빌드하고 실행합니다. 첫 번째 단계에서 구성한 맞춤 스타일은 ID가 있는 모든 지도에 적용됩니다.