マップ ID を使用する
マップ ID は、特定の地図のスタイルまたは対象物に関連付けられた識別子です。Google Cloud Console で地図のスタイルを設定してマップ ID に関連付け、コード内でマップ ID を参照すると、関連するマップスタイルがアプリに表示されます。以降に行われるスタイルの更新が自動的にアプリに反映されるため、ユーザー自らが更新する必要がなくなります。
作成時に、マップ ID がプロジェクトに関連付けられ、 1 つのプラットフォーム(Android、iOS、JavaScript)または Maps Static API
Cloud コンソールでマップ ID を作成または管理するには、 そのプロジェクトのプロジェクト オーナーまたはプロジェクト編集者の IAM ロール。
必要な権限
マップ ID または地図のスタイルを サービス アカウントを保持する場合は、 IAM ロールのオーナーまたは編集者 割り当てることができます。
マップ ID を作成する
マップ ID は、Google Cloud のアプリケーションの 1 つのインスタンスを表す マップ。いつでも、マップ ID の作成と、マップ ID に関連付けられたスタイルの更新が可能です。 確認できます。
マップ ID を作成するには:
- Cloud Console で、[マップ管理] ページに移動します。
- [新しいマップ ID を作成] を選択して、[新しいマップ ID を作成] フォームを表示します。
フォーム内で次の操作を行います。
- 地図の名前を指定します。
- 地図の種類またはプラットフォームを指定します。
- JavaScript マップの場合は、ラスターマップまたはベクターマップを選択します。
- 地図の説明文を入力します。
- [次へ] を選択して新しいマップ ID を表示します。
マップ ID を地図のスタイルに関連付ける
以下の手順は、プロジェクトに既存の地図のスタイルが少なくとも 1 つあることを前提としています。
- Cloud Console で、[マップ管理] ページに移動します。
- このページの [地図名] 列から既存のマップ ID を選択します。
- このフォームの下部の [このマップ ID に関連付けられた地図のスタイル] プルダウンから地図のスタイルを選択します。
- [保存] を選択します。
マップ ID をアプリに追加する
Android
アクティビティの <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 を持つすべての地図に適用されます。
iOS
マップ ID を使用して地図をインスタンス化する手順は次のとおりです。
- Cloud コンソールのマップ ID 文字列を使用して
GMSMapID
を作成します。 - 作成したマップ ID を指定して
GMSMapView
を作成します。
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
longitude:-122.336471
zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
独自のマップ ID を使用している場合は、マップ ID を設定できます。 いつでも新しいスタイルに変更できます。 そのスタイルがマップビューに自動的に反映され 約 6 時間でユーザーを獲得しました
変更をすぐに確認するには、いったん閉じて再起動してください。 アプリを強制終了して、最近使用した アプリの一覧を開いて再度開きます。更新された地図が表示されます。
JavaScript
アプリケーション コードでマップ ID を使用して地図を作成する手順は次のとおりです。
埋め込み JSON コードを使用して地図をカスタマイズしている場合は、
MapOptions
オブジェクトからstyles
プロパティを削除します。それ以外の場合は、この手順は省略してください。mapId
プロパティを使用して、マップ ID を地図に追加します。例:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Maps Static
Google のマップ ID を使用する新規または既存の地図にマップ ID を追加するには、
ウェブサービス API の場合は、map_id
URL パラメータを追加して、マップ ID を設定します。
この例では、Maps Static API を使用してマップ ID を地図に追加しています。
<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />
マップ ID 使用時に利用できる対象物
Cloud ベースのマップのスタイル設定: Google Cloud コンソールを使用して、地図のスタイルの設定、カスタマイズ、管理を行います。
すべてのプラットフォーム(Android、JavaScript、iOS、Maps Static API)で利用可能
ベクターマップ: 読み込み時に描画される、ベクターベースのタイルで構成される地図
WebGL を使用してクライアント側で実行できます
JavaScript で利用可能