ナビゲーション UI を変更する

Navigation SDK for iOS を使用すると、地図に表示する組み込みの UI コントロールや要素、許可する操作を指定して、地図のユーザー エクスペリエンスを変更できます。Navigation UI の外観を変更することもできます。ナビゲーション UI の許容される変更に関するガイドラインについては、ポリシーページをご覧ください。

地図の UI コントロール

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

コンパス

Navigation SDK を使用して、特定の状況下で地図の右上にコンパス グラフィックを表示することができます。ユーザーがコンパスをタップすると、カメラの方向がゼロの位置(デフォルトの向き)に戻る様子がアニメーション表示されてから、間もなくコンパスが消えます。

ナビゲーションが有効で、カメラモードが「追従」に設定されている場合、コンパスは表示されたままになり、コンパスをタップすると、傾斜カメラと概要カメラの視点が切り替わります。

ドライバーの注意散漫を防ぐため、ヘッダー(ポートレート モード)が拡大してコンパスのデフォルトの位置と競合する場合でも、コンパスは同じ位置に留まります。セカンダリ ヘッダーのカスタム コントロールまたはヘッダー アクセサリー ビューを追加すると、UI の競合を避けるためにコンパスが非表示になります。

コンパスは、日中モードと夜間モード、ダークモードに対応しています。

コンパスは、バージョン 11.0.0 以降ではデフォルトで有効になっています。コンパスを無効にするには、GMSUISettings の compassButton プロパティを false に設定します。

Swift

mapView.settings.compassButton = false

Objective-C

mapView.settings.compassButton = NO;

現在地ボタン

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

Swift

mapView.settings.myLocationButton = true

Objective-C

mapView.settings.myLocationButton = YES;

[中央に戻す] ボタン

ナビゲーションが有効になっている場合、ユーザーが地図ビューをスクロールすると、[再センタリング] ボタンが表示されます。ユーザーがタップして地図を再センタリングすると、このボタンは消えます。[中央に戻す] ボタンを表示するには、GMSUISettings の recenterButtonEnabled プロパティを true に設定します。[再センタリング] ボタンが表示されないようにするには、recenterButtonEnabled を false に設定します。

Swift

mapView.settings.isRecenterButtonEnabled = true

Objective-C

mapView.settings.recenterButtonEnabled = YES;

地図の UI アクセサリー

Navigation SDK には、ナビゲーション中に表示される UI アクセサリーが用意されています。これは、Google マップ(iOS 版)アプリに表示されるものと同様です。このセクションで説明するように、これらのコントロールの表示 / 非表示や外観を調整できます。ここで行った変更は、ユーザーの次回の移動中に反映されます。

ナビゲーション中は、画面の上部にナビゲーション ヘッダー、下部にナビゲーション フッターが表示されます。ナビゲーション ヘッダーには、ルート上の次の曲がり角の道路名と方向、およびその次の曲がり角の方向が表示されます。ナビゲーション フッターには、目的地までの予想時間と距離、および予定到着時刻が表示されます。

次のプロパティを使用して、ナビゲーションのヘッダーとフッターの表示を切り替えたり、色をプログラムで設定したりできます。

次のコード例では、ヘッダーとフッターの表示を有効にしてから、navigationHeaderPrimaryBackgroundColor を青に、navigationHeaderSecondaryBackgroundColor を赤に設定しています。

Swift

mapView.settings.isNavigationHeaderEnabled = true
mapView.settings.isNavigationFooterEnabled = true
mapView.settings.navigationHeaderPrimaryBackgroundColor = .blue
mapView.settings.navigationHeaderSecondaryBackgroundColor = .red

Objective-C

mapView.settings.navigationHeaderEnabled = YES;
mapView.settings.navigationFooterEnabled = YES;
mapView.settings.navigationHeaderPrimaryBackgroundColor = [UIColor blueColor];
mapView.settings.navigationHeaderSecondaryBackgroundColor = [UIColor redColor];

セカンダリ ナビゲーション ヘッダービューを独自のカスタマイズされたアクセサリー ビューに置き換えることで、アプリをカスタマイズできます。これを行うには、GMSNavigationAccessoryView プロトコルを実装するビューを作成します。このプロトコルには、必須のメソッド -heightForAccessoryViewConstrainedToSize:onMapView: が 1 つあります。指定された mapView でビューに使用できる最大サイズが提供されるため、ビューに必要な高さを指定する必要があります。

このビューを setHeaderAccessoryView: を呼び出して mapView に渡します。mapView は、現在のビューをアニメーションでフェードアウトし、カスタムビューをアニメーションでフェードインします。カスタムビューを表示するには、ナビゲーション ヘッダーが表示されている必要があります。

カスタム ヘッダー アクセサリー ビューを削除するには、nil を setHeaderAccessoryView: に渡します。

ビューのサイズをいつでも変更する必要がある場合は、invalidateLayoutForAccessoryView: を呼び出して、サイズを変更する必要があるビューを渡します。

例

次のコード例は、GMSNavigationAccessoryView プロトコルを実装するカスタムビューを示しています。このカスタムビューは、カスタム ナビゲーション ヘッダー アクセサリー ビューの設定に使用されます。

Swift

class MyCustomView: UIView, GMSNavigationAccessoryView {
…
  func heightForAccessoryViewConstrained(to size: CGSize, on mapView: GMSMapView) -> CGFloat {
    // viewHeight gets calculated as the height your view needs.
    return viewHeight
  }
…
}

let customView = MyCustomView(...)
mapView.setHeaderAccessory(customView)

// At some later point customView changes size.
mapView.invalidateLayout(forAccessoryView: customView)

// Remove the custom header accessory view.
mapView.setHeaderAccessory(nil)

Objective-C

@interface MyCustomView : UIView <GMSNavigationAccessoryView>
…
@end

@implementation MyCustomView
…
- (CGFloat)heightForAccessoryViewConstrainedToSize:(CGSize)size onMapView:(GMSMapView *)mapView {
  // viewHeight gets calculated as the height your view needs.
  return viewHeight;
}
…
@end

MyCustomView *customView = [[MyCustomView alloc] init…];
[_mapView setHeaderAccessoryView:customView];

// At some later point customView changes size.
[_mapView invalidateLayoutForAccessoryView:customView];

// Remove the custom header accessory view.
[_mapView setHeaderAccessoryView:nil];

ローライト モードのヘッダーの色

Navigation SDK for iOS は、時刻とデバイスの現在地に基づいて推奨されるライトモードを計算し、推奨されるモードが変更されたとき(日の出や日の入りなど)に GMSNavigatorListener.didChangeSuggestedLightingMode リスナー メソッドを呼び出します。ローライト モードの動作は、次の方法でプログラムによって変更できます。

ルートリスト

アプリでルート案内をステップごとに表示できます。次の例は、その方法の 1 つを示しています。これらの手順は、独自の実装によって異なる場合があります。

  1. GMSNavigator(ナビゲーター)の setDestinations が正常に完了し、ナビゲーターの guidanceActive が有効になったら、エントリ ポイント ボタンを有効にします。
  2. ユーザーがエントリ ポイント ボタンをタップしたら、GMSMapView(mapView)に関連付けられたナビゲータを使用して GMSNavigationDirectionsListController(コントローラ)を作成します。
  3. コントローラを UIViewController(ビュー コントローラ)のインスタンスに追加し、directionsListView をビュー コントローラのサブビューとして追加します。コントローラの reloadData メソッドと invalidateLayout メソッドは、UICollectionView と同様に呼び出す必要があります。
  4. ビュー コントローラをアプリのビュー コントローラ階層にプッシュします。

次のコード例は、DirectionsListViewController を追加する方法を示しています。

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  // Add the directionsListView to the host view controller's view.
  let directionsListView = directionsListController.directionsListView
  directionsListView.frame = self.view.frame
  self.view.addSubview(directionsListView)
  directionsListView.translatesAutoresizingMaskIntoConstraints = false
  directionsListView.topAnchor.constraint(equalTo: self.view.topAnchor).isActive = true
  directionsListView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor).isActive = true
  directionsListView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor).isActive = true
  directionsListView.bottomAnchor.constraint(equalTo: self.view.bottomAnchor).isActive = true
  ...
}

override func viewWillAppear(_ animated: Bool) {
  super.viewWillAppear(animated)
  // Make sure data is fresh when the view appears.
  directionsListController.reloadData()
  ...
}

override func willTransition(to newCollection: UITraitCollection, with coordinator: UIViewControllerTransitionCoordinator) {
  super.willTransition(to: newCollection, with: coordinator)
  // Invalidate the layout during rotation.
  coordinator.animate(alongsideTransition: {_ in
    self.directionsListController.invalidateLayout()
  })
  ...
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  // Add the directionsListView to the host view controller's view.
  UIView *directionsListView = _directionsListController.directionsListView;
  directionsListView.frame = self.view.bounds;
  [self.view addSubview:directionsListView];
  directionsListView.translatesAutoresizingMaskIntoConstraints = NO;
  [directionsListView.topAnchor constraintEqualToAnchor:self.view.topAnchor].active = YES;
  [directionsListView.leadingAnchor constraintEqualToAnchor:self.view.leadingAnchor].active = YES;
  [directionsListView.trailingAnchor constraintEqualToAnchor:self.view.trailingAnchor].active = YES;
  [directionsListView.bottomAnchor constraintEqualToAnchor:self.view.bottomAnchor].active = YES;
  ...
}

- (void)viewWillAppear:(BOOL)animated {
  [super viewWillAppear:animated];
  // Make sure data is fresh when the view appears.
  [_directionsListController reloadData];
  ...
}

- (void)willTransitionToTraitCollection:(UITraitCollection *)newCollection
              withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
  [super willTransitionToTraitCollection:newCollection withTransitionCoordinator:coordinator];
  void(^animationBlock)(id <UIViewControllerTransitionCoordinatorContext>context) =
      ^void(id <UIViewControllerTransitionCoordinatorContext>context) {
    [_directionsListController invalidateLayout];
  };
  // Invalidate the layout during rotation.
  [coordinator animateAlongsideTransition:animationBlock
                               completion:nil];
  ...
}

...

トリップの進行状況バー

ナビゲーションにトリップの進行状況バーを追加しました。

トリップの進行状況バーは、ナビゲーションの開始時に地図の開始 / 先頭側に表示される縦棒です。有効にすると、ルート全体の概要が、ユーザーの目的地と現在地とともに表示されます。

これにより、ユーザーはズームインしなくても、交通状況などの今後の問題を予測できます。必要に応じて、ルートを変更できます。ユーザーがルートを変更すると、進行状況バーがリセットされ、その時点から新しいルートが開始されたかのように表示されます。

ルートの進行状況バーには、次のステータス インジケーターが表示されます。

  • トラフィック ステータス - 今後のトラフィックのステータス。

  • 現在地 - ルート上のドライバーの現在地。

  • ルートの経過部分 - ルートの経過部分。

GMSUISettings で navigationTripProgressBarEnabled プロパティを設定して、ルートの進行状況バーを有効にします。

Swift

mapView.settings.isNavigationTripProgressBarEnabled = true

Objective-C

mapView.settings.navigationTripProgressBarEnabled = YES;

ルートの進行状況バーの位置

  • バーの左側は、スピードメーター、Google ロゴ、[中心を再設定] ボタン(表示されている場合)の左側とほぼ揃っています。幅は 12 pt です。
  • ルートの進行状況バーは、画面の垂直方向のスペースに応じて動的に変化します。バーの下部は、画面の下部から 210 pt の位置にあります。ルートの進行状況バーの上部は、画面の上部から 170 pt 以上離れた位置に表示されます。バーの最大高さは 400 pt です。
  • ルートの進行状況バーがナビゲーション ヘッダーや他のナビゲーション UI 要素と重なる場合は、それらの要素の下に表示されます。

Prompt Visibility API(試験運用版)

Prompt Visibility API を使用すると、Navigation SDK によって生成される UI 要素と独自のカスタム UI 要素との競合を回避できます。この API では、Navigation SDK の UI 要素が表示される直前と、要素が削除された直後にコールバックを受け取るリスナーを追加できます。コードサンプルを含む詳細については、リアルタイムの運行状況を構成するページの Prompt Visibility API セクションをご覧ください。

速度計のコントロール

ナビゲーションが有効で、移動モードが運転に設定されている場合、Navigation SDK for iOS では、地図の下隅に速度制限コントロールが表示され、現在の速度制限が表示されます。ドライバーが制限速度を超えると、コントロールが展開され、ドライバーの現在の速度を示す 2 つ目の速度計が表示されます。

アラートレベルを設定すると、ドライバーが指定された速度を超過したときに、スピードメーターの表示形式を変更できます。たとえば、ドライバーが制限速度を時速 5 マイル超過した場合は現在の速度を赤色のテキストで表示し、制限速度を時速 10 マイル超過した場合は赤色の背景で表示するように指定できます。

速度制限コントロールを表示するには、GMSMapView の shouldDisplaySpeedometer プロパティを true に設定します。速度制限コントロールの表示を無効にするには、shouldDisplaySpeedometer を false に設定します。

Swift

mapView.shouldDisplaySpeedometer = true

Objective-C

mapView.shouldDisplaySpeedometer = YES;

速度計のアラートを設定する方法については、速度計のアラートを構成するをご覧ください。

目的地マーカー

GMSUISettings の showsDestinationMarkers プロパティを設定することで、特定のルートの目的地マーカーを表示または非表示にできます。次の例は、目的地のマーカーをオフにする方法を示しています。

Swift

mapView.settings.showsDestinationMarkers = false

Objective-C

mapView.settings.showsDestinationMarkers = NO;

地図エクスペリエンスの機能

Navigation SDK を使用すると、ユーザーのナビゲーション エクスペリエンスをさらにカスタマイズできます。インスタンスに加えた変更は、ユーザーが次にアプリを更新したときに反映されます。

目的地のハイライト表示と入り口

目的地のハイライト表示と入り口

placeID を使用して目的地が作成されると、目的地の建物がハイライト表示され、可能な場合は入口アイコンが表示されます。これらの視覚的な手がかりは、ユーザーが目的の場所を識別して移動するのに役立ちます。

placeID を使用してデスティネーションを作成するには、placeID を受け入れる GMSNavigationWaypoint 初期化子のいずれかを使用します。たとえば、ルートをナビゲートするチュートリアルで作成された目的地には、目的地のハイライト表示と入り口ラベルが含まれます(利用可能な場合)。

ナビゲーション中の建物の 3D 表示

ナビゲーション中の建物の 3D 表示

デフォルトでは、ナビゲーション中に建物の 3D 表示が表示されます。この機能を無効にするには、buildingsEnabled を false(Swift)または NO(Objective-C)に設定します。

デフォルトの地図操作を無効にする

地図上のデフォルトの操作を無効にするには、GMSUISettings クラスのプロパティを設定します。このクラスは、GMSMapView のプロパティとして使用できます。次のジェスチャーはプログラムで有効にしたり無効にしたりすることができます。なお、操作を無効にしても、カメラ設定へのプログラムによるアクセスは制限されません。

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

この例では、パンとズームの両方の操作が無効になっています。

Swift

mapView.settings.scrollGestures = false
mapView.settings.zoomGestures = false

Objective-C

mapView.settings.scrollGestures = NO;
mapView.settings.zoomGestures = NO;

コントロールと UI 要素を配置する

次のプロパティを使用すると、ナビゲーション ヘッダーとフッターの位置を基準にして、コントロールやその他の UI 要素を配置できます。

  • navigationHeaderLayoutGuide
  • navigationFooterLayoutGuide
  • bottomTrailingButtonsLayoutGuide

次のコード例は、レイアウト ガイドを使用して、地図ビューにラベルのペアを配置する方法を示しています。

Swift

/* Add a label to the top left, positioned below the header. */
let topLabel = UILabel()
topLabel.text = "Top Left"
mapView.addSubview(topLabel)
topLabel.translatesAutoresizingMaskIntoConstraints = false
topLabel.topAnchor.constraint(equalTo: mapView.navigationHeaderLayoutGuide.bottomAnchor).isActive = true
topLabel.leadingAnchor.constraint(equalTo: mapView.leadingAnchor).isActive = true

/* Add a label to the bottom right, positioned above the footer. */
let bottomLabel = UILabel()
bottomLabel.text = "Bottom Right"
mapView.addSubview(bottomLabel)
bottomLabel.translatesAutoresizingMaskIntoConstraints = false
bottomLabel.bottomAnchor.constraint(equalTo: mapView.navigationFooterLayoutGuide.topAnchor).isActive = true
bottomLabel.trailingAnchor.constraint(equalTo: mapView.trailingAnchor).isActive = true

Objective-C

/* Add a label to the top left, positioned below the header. */
UILabel *topLabel = [[UILabel alloc] init];
topLabel.text = @"Top Left";
[view addSubview:topLabel];
topLabel.translatesAutoresizingMaskIntoConstraints = NO;
[topLabel.topAnchor
    constraintEqualToAnchor:mapView.navigationHeaderLayoutGuide.bottomAnchor].active = YES;
[topLabel.leadingAnchor constraintEqualToAnchor:mapView.leadingAnchor].active = YES;

/* Add a label to the bottom right, positioned above the footer. */
UILabel *bottomLabel = [[UILabel alloc] init];
bottomLabel.text = @"Bottom Right";
[view addSubview:bottomLabel];
bottomLabel.translatesAutoresizingMaskIntoConstraints = NO;
[bottomLabel.bottomAnchor
    constraintEqualToAnchor:mapView.navigationFooterLayoutGuide.topAnchor].active = YES;
[bottomLabel.trailingAnchor constraintEqualToAnchor:mapView.trailingAnchor].active = YES;

bottomTrailingButtonsLayoutGuide を使用してリアルタイムの運行状況レポートボタンを配置する方法の例については、リアルタイムの運行状況を構成するをご覧ください。

代替ルートを非表示にする

ユーザー インターフェースに表示される情報が多すぎる場合は、代替ルートの表示数をデフォルト(2 つ)より減らすか、代替ルートをまったく表示しないようにすることで、表示を整理できます。このオプションは、ルートを取得する前に GMSNavigationRoutingOptions を構成し、alternateRoutesStrategy を次のいずれかの列挙値に設定することで構成できます。

列挙値説明
GMSNavigationAlternateRoutesStrategyAll デフォルト。最大 2 つの代替ルートを表示します。
GMSNavigationAlternateRoutesStrategyOne 別のルートを 1 つ表示します(利用可能な場合)。
GMSNavigationAlternateRoutesStrategyNone 別のルートを非表示にします。

例

次のコード例は、代替ルートを完全に非表示にする方法を示しています。

Swift

let routingOptions = GMSNavigationRoutingOptions(alternateRoutesStrategy: .none)
navigator?.setDestinations(destinations,
                           routingOptions: routingOptions) { routeStatus in
  ...
}

Objective-C

GMSNavigationRoutingOptions *routingOptions = [[GMSNavigationRoutingOptions alloc] initWithAlternateRoutesStrategy:GMSNavigationAlternateRoutesStrategyNone];
[navigator setDestinations:destinations
            routingOptions:routingOptions
                  callback:^(GMSRouteStatus routeStatus){...}];