コントロールと操作

Maps SDK for iOS を使用すると、地図に表示する組み込みの UI コンポーネントや許可する操作を指定して、ユーザーが地図を操作する方法をカスタマイズできます。

地図のコントロール

Maps SDK for iOS には、iOS 版 Google マップ アプリのものと同様の組み込み UI コントロールが用意されています。これらのコントロールの表示と非表示を切り替えるには、GMSUISettings クラスを使用します。このクラスに加えられた変更は、すぐにマップに反映されます。

コンパス

Maps SDK for iOS には、特定の状況下でマップの右上隅に表示される、コンパス グラフィックがあります。コンパスは、カメラの向きをゼロ以外の方向として指定している場合にのみ表示されます。ユーザーがコンパスをクリックすると、方向指定がゼロの位置（デフォルトの向き）にカメラの表示が戻り、その後、コンパスが徐々に消えていきます。

デフォルトでは、コンパスは無効化されています。コンパスを有効にするには、GMSUISettings の compassButton プロパティを YES に設定します。ただし、コンパスが常に表示されるように設定することはできません。

let camera = GMSCameraPosition(latitude: 37.757815, longitude: -122.50764, zoom: 12)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.settings.compassButton = true
      

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:37.757815
                                                        longitude:-122.50764
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
mapView.settings.compassButton = YES;
      

現在地ボタン

現在地ボタンは、現在地ボタンが有効になっている場合にのみ、画面の右下隅に表示されます。ユーザーがボタンをクリックしたときに、ユーザーの現在地がわかっている場合は、アニメーションでカメラが現在地に合わせられます。ボタンを有効にするには、GMSUISettings の myLocationButton プロパティを YES に設定します。

mapView.settings.myLocationButton = true
      

mapView.settings.myLocationButton = YES;
      

床の選択ツール

インドアマップが前面に表示されると、階数ピッカー コントロールが画面右下付近に表示されます。複数のインドアマップが表示されている場合、階数ピッカーは最も画面中央に近い建物に対応するものになります。各建物には、ピッカーが最初に表示されたときに選択される、デフォルトの階があります。ピッカーを使用すると、別の階を選択できます。

階数ピッカー コントロールを無効にするには、GMSUISettings の indoorPicker プロパティを NO に設定します。

mapView.settings.indoorPicker = false
      

mapView.settings.indoorPicker = NO;
      

地図の操作

GMSMapView のプロパティとして使用できる GMSUISettings クラスのプロパティを設定することによって、マップのデフォルトの操作を無効にすることができます。次のジェスチャーはプログラムで有効にしたり無効にしたりすることができます。操作を無効にしても、プログラムからのカメラ設定へのアクセスは制限されないことに注意してください。

• scrollGestures - スクロール操作を有効にするか無効にするかを制御します。有効な場合、ユーザーはスワイプによってカメラをパンすることができます。
• zoomGestures - ズーム ジェスチャーを有効または無効にします。有効な場合、ユーザーはダブルタップ、2 本指タップ、ピンチによってカメラをズームすることができます。scrollGestures が有効な場合にダブルタップやピンチを行うと、カメラが指定の場所にパンされる場合があることに注意してください。
• tiltGestures - チルト操作を有効にするか無効にするかを制御します。有効な場合、ユーザーは 2 本指で上下にスワイプすることによってカメラをチルトすることができます。
• rotateGestures - 回転ジェスチャーを有効または無効にします。有効な場合、ユーザーは 2 本指で回転操作を行うことによってカメラを回転することができます。

次の例では、パン操作とズーム操作を無効にしています。

override func loadView() {
  let camera = GMSCameraPosition.camera(
    withLatitude: 1.285,
    longitude: 103.848,
    zoom: 12
  )

  let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
  mapView.settings.scrollGestures = false
  mapView.settings.zoomGestures = false
  self.view = mapView
}
      

- (void)loadView {
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.settings.scrollGestures = NO;
  mapView.settings.zoomGestures = NO;
  self.view = mapView;
}