開始する

データセット用データドリブン スタイル設定を設定する手順は次のとおりです。

API キーを取得して API を有効化する

データセット用データドリブン スタイル設定を使用するには、請求先アカウントが登録された Cloud プロジェクトを用意し、Maps SDK for iOS と Maps Datasets API の両方を有効化しておく必要があります。詳しくは、次をご覧ください。

マップ ID を作成する

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

Google Cloud コンソールのスクリーンショット

地図のスタイルを新規作成する

新しい地図のスタイルを作成するには、地図のスタイルを管理するの手順に沿ってスタイルを作成します。完了したら、スタイルを新しく作成したマップ ID に関連付けます。

地図の初期化コードを更新する

この手順では、1 つ以上の対象物レイヤが有効になっているスタイルにマップ ID を関連付ける必要があります。Cloud コンソールでマップ 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 を呼び出すことで、特定の機能（データドリブン スタイル設定など）が使用可能かどうかを確認できます。

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

次のステップ