ルートを移動する

このガイドでは、Navigation SDK for iOS を使用して、アプリ内で 1 つの目的地へのルートをプロットする方法について説明します。

概要

  1. プロジェクトを設定するの説明に沿って、Navigation SDK をアプリに統合します。
  2. GMSMapView を構成します。
  3. 利用規約に同意し、位置情報サービスとバックグラウンド通知を許可するようユーザーに求める。
  4. 1 つ以上の宛先を含む配列を作成します。

  5. ターンバイターン方式のナビを制御する GMSNavigator を定義します。

    • setDestinations を使用して宛先を追加します。
    • ナビゲーションを開始するには、isGuidanceActive を true に設定します。
    • simulateLocationsAlongExistingRoute を使用して、ルートに沿った車両の進行状況をシミュレートし、アプリのテスト、デバッグ、デモを行います。

コードの確認

必要な承認をユーザーに求める

Navigation SDK を使用する前に、ユーザーは利用規約に同意し、ナビゲーションに必要な位置情報サービスの使用を許可する必要があります。アプリがバックグラウンドで実行される場合は、ガイダンス アラート通知を承認するようユーザーに求める必要があります。このセクションでは、必要な認証プロンプトを表示する方法について説明します。

位置情報サービスを承認する

Navigation SDK は位置情報サービスを使用するため、ユーザーの承認が必要です。位置情報サービスを有効にして、認証ダイアログを表示する手順は次のとおりです。

  1. Xcode で位置情報とバックグラウンド機能を有効にします。

    1. Xcode でターゲットを開き、[Signing & Capabilities] タブを選択します。詳しくは、アプリに機能を追加するに関する Apple のガイドをご覧ください。
    2. 位置情報（常に）と位置情報（使用中）の機能を追加します。それぞれのテキスト フィールドに、アプリが位置情報サービスを必要とする理由を簡単に説明します（例: 「このアプリは、ターンバイターン方式のナビに位置情報サービスを使用する権限が必要です」）。
    3. [Background Modes] 機能を有効にして、[Location updates] チェックボックスをオンにします。この機能がないと、ナビゲーションの開始時にアプリがクラッシュします。詳しくは、バックグラウンドでの位置情報の更新の処理に関する Apple のガイドをご覧ください。

  2. 認証ダイアログを表示するには、位置情報マネージャー インスタンスの requestAlwaysAuthorization() メソッドを呼び出します。

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

位置情報サービスの承認に関する Apple のドキュメント全文をご覧ください。

バックグラウンド ガイダンスのアラート通知を承認する

Navigation SDK がバックグラウンドで実行されているときにアラート通知を表示するには、ユーザー権限が必要です。次のコードを追加して、これらの通知を表示する権限をユーザーにリクエストします。

Swift

UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}

Objective-C

// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];

モーション センサーを承認する

今後のメジャー リリースでは、Navigation SDK for iOS は、コア位置情報とデバイスのモーション センサー（CMAltimeter）を組み合わせて、ルートの高度を計算します。SDK が高度計にアクセスすると、iOS はこの文字列を使用してユーザーに権限を求めるプロンプトを自動的に表示します。

このキーを追加しても、現在の動作には影響しませんが、後で SDK をアップグレードしたときに初期化クラッシュが発生するのを防ぐことができます。

SDK の将来のアップグレードに備えて、モーション センサーの認証を次のように構成します。

  1. Xcode でターゲットを開き、[Info] タブに移動するか、Info.plist ファイルを開きます。

  2. 新しいキー Privacy - Motion Usage Description（NSMotionUsageDescription）を追加します。

  3. お客様に簡単な説明を添えます。例: 「このアプリは、高度を計算し、地図のルートの精度を向上させるために、モーション センサーへのアクセスを必要とします。」

利用規約に同意します

次のコードを使用して、利用規約ダイアログを表示し、ユーザーが利用規約に同意したときにナビゲーションを有効にします。この例には、位置情報サービスとガイダンス アラート通知のコード（前述）が含まれています。

Swift

  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")

  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true

      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()

      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }

Objective-C

GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];

[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;

     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];

     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];

ルートを作成して案内を開始する

ルートをプロットするには、ナビゲーターの setDestinations メソッドを呼び出し、1 つ以上の GMSNavigationWaypoint 目的地の配列を渡します。ルートが正常に計算されると、地図上に表示されます。ルートに沿ったガイダンスを開始するには、コールバックで isGuidanceActive を true に設定します。

次の例は、以下の条件に従って表示します。

  • 1 つの目的地を含む新しいルートを作成する。
  • ナビを開始します。
  • バックグラウンドでのルート案内通知を有効にする。
  • ルートに沿った移動のシミュレーション（省略可）。
  • カメラモードを「追尾」に設定する（省略可）。

Swift

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)

  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}

Objective-C

- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

プレイス ID について詳しくは、プレイス ID をご覧ください。

複数経由地のシナリオ

設定できるウェイポイントは最大 25 個です。

setDestinations メソッドは、複数の目的地を含むルートをサポートしていません。continueToNextDestinationWithCompletion() を使用して、ウェイポイントをルートの次の区間に進めます。

移動手段を設定する

移動モードは、取得するルートの種類と、ユーザーのコースを決定する方法の両方を定義します。ルートには、車、自転車、徒歩、タクシーの 4 つの移動手段のいずれかを設定できます。運転モードとタクシーモードでは、ユーザーのコースは移動方向に基づきます。自転車モードと徒歩モードでは、コースはデバイスが向いている方向（横表示モードではデバイスの上部に向かう方向）で表されます。

次の例に示すように、地図ビューの travelMode プロパティを設定します。

Swift

self.mapView.travelMode = .cycling

Objective-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

避ける道路を設定する

avoidsHighways プロパティと avoidsTolls BOOL プロパティを使用して、ルート上の高速道路、有料道路、またはその両方を回避します。

Swift

self.mapView.navigator?.avoidsTolls = true

Objective-C

_mapView.navigator.avoidsTolls = YES;

音声ガイダンスの音量を設定する

音声案内の音量を調整するには、ナビゲーターの volumeLevel プロパティを低、中、高のいずれかに設定します。ナビゲーターは、最後に保存された音量レベルを使用します。デフォルトは標準です。

Swift

self.mapView.navigator?.volumeLevel = .low

Objective-C

_mapView.navigator.volumeLevel = GMSNavigationVolumeLevelLow;

PlaceID 検索ツール

PlaceID Finder を使用して、ルートの目的地に使用するプレイス ID を見つけることができます。GMSNavigationWaypoint を使用して placeID からデスティネーションを追加します。

フローティング テキスト

Google の帰属表示が隠れない限り、アプリ内のどこにでもフローティング テキストを追加できます。Navigation SDK では、地図上の特定の座標（緯度、経度）やラベルにテキストを固定することはできません。詳細については、情報ウィンドウをご覧ください。