データセット用データドリブン スタイル設定をセットアップする手順は次のとおりです。
API キーを取得して API を有効化する
データセット用データドリブン スタイル設定を使用する前に、請求先アカウントが登録された Cloud プロジェクトを用意し、Maps SDK for iOS と Maps Datasets API を有効化しておく必要があります。詳しくは、次をご覧ください。
マップ ID を作成する
mapID は、Google マップの 1 つのインスタンスを表す一意の識別子です。マップ ID の作成と、マップ ID に関連付けられたスタイルの更新は、Google Cloud コンソールでいつでも行えます。
新しい地図のスタイルを作成する
地図のスタイルを新規作成するには、地図のスタイルを管理するの手順に沿ってスタイルを作成します。完了したら、スタイルを新しく作成したマップ ID に関連付けます。
地図の初期化コードを更新する
この手順では、対象物レイヤが 1 つ以上有効になっているスタイルにマップ ID を関連付ける必要があります。Cloud コンソールでマップ ID が正しく設定されていることを確認するには、[マップ管理] でマップ ID の構成を確認します。
Swift
// A map ID using a style with one or more feature layers enabled let mapID = GMSMapID(identifier: "YOUR_MAP_ID") let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))
Objective-C
// A map ID using a style with one or more feature layers enabled GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"]; GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];
地図の機能をチェックする
データセット用データドリブン スタイル設定を使用するには、対応する capabilities が Google Cloud コンソールで有効化され、マップ ID と関連付けられている必要があります。マップ ID は変更される可能性があるため、GMSMapView
で mapView.mapCapabilities
を呼び出して、特定の capability(データドリブン スタイル設定など)が利用可能かどうか、実際にそれを呼び出す前に確認できます。
GMSViewDelegate
を購読して、地図の機能の変更を検出することもできます。この例は、プロトコルを使用してデータドリブン スタイル設定の要件を確認する方法を示しています。
Swift
class SampleViewController: UIViewController { private lazy var mapView: GMSMapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7)) override func loadView() { self.view = mapView mapView.delegate = self } } extension SampleViewController: GMSMapViewDelegate { func mapView(_ mapView: GMSMapView, didChange mapCapabilities: GMSMapCapabilityFlags) { if (!mapCapabilities.contains(.dataDrivenStyling)) { // Data-driven styling is *not* available, add a fallback. // Existing feature layers are also unavailable. } } }
Objective-C
@interface SampleViewController: UIViewController <GMSMapViewDelegate> @end @implementation SampleViewController - (void)loadView { GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]]; mapView.delegete = self; self.view = mapView; } - (void)mapView:(GMSMapView *)mapView didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities { if (!(mapCapabilities & GMSMapCapabilityFlagsDataDrivenStyling)) { // Data-driven styling is *not* available, add a fallback. // Existing feature layers are also unavailable. } } @end