マップ ID を使用する

マップ ID は、Google Cloud Console で作成し、スタイルと関連付ける識別子で、アプリコードに格納され、そのスタイルを地図に適用します。

マップ ID は、作成時にプロジェクトに関連付けられ、単一のプラットフォーム（Android、iOS、JavaScript）または Maps Static API に限定されます。

Cloud Console でマップ ID を作成または管理するには、プロジェクト所有者またはプロジェクト編集者の IAM の役割が必要です。

マップ ID を作成する

マップ ID は、Google マップの 1 つのインスタンスを表す一意の識別子です。マップ ID の作成と、マップ ID に関連付けられたスタイルの更新は、Cloud Console でいつでも行えます。

マップ ID の作成方法:

Cloud Console で、[マップ管理] ページに移動します。
[新しいマップ ID を作成] を選択して、[新しいマップ ID を作成] フォームを表示します。

フォーム内で次の操作を行います。
- 地図の名前を指定します。
- 地図の種類またはプラットフォームを指定します。
- JavaScript マップの場合は、ラスターマップまたはベクターマップを選択します。
- 地図の説明文を入力します。
- [次へ] を選択して、新しいマップ ID を表示します。

マップ ID を地図のスタイルに関連付ける

以下の手順は、プロジェクトに既存の地図のスタイルが少なくとも 1 つあることを前提としています。

Cloud Console で、[マップ管理] ページに移動します。
このページの [地図の名前] 列から既存のマップ ID を選択します。
このフォームの下部の [このマップ ID に関連付けられた地図のスタイル] プルダウンから地図のスタイルを選択します。
[保存] を選択します。

マップ ID をアプリに追加する

アクティビティのレイアウトファイルの <fragment> 要素を使ってマップ ID を追加するには、MapView クラスを使用するか、プログラムで GoogleMapOptions クラスを使用します。

たとえば、map_id という名前の文字列値として res/values/strings.xml に保存されているマップ ID を作成したとします。

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

アクティビティのレイアウトファイルで <fragment> 要素を使って追加した地図の場合、カスタムスタイルを持つすべての地図フラグメントで、map:mapId 属性にマップ ID を指定する必要があります。

<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 クラスを使って MapFragment インスタンスに渡します。

Java

  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 Studio で、通常どおりにアプリをビルドして実行します。最初の手順で設定したカスタムスタイルは、ID を持つすべての地図に適用されます。