Navigation SDK for iOS クイック リファレンス

Navigation SDK for iOS を使用すると、Google マップのターンバイターン方式のナビを iOS アプリに追加できます。UI のカスタマイズやルートの設定も可能です。このライブラリは、地図のレイヤを提供する Maps SDK for iOS を拡張するもので、アプリにインストールする必要があります。

Navigation SDK for iOS: 主な特長

  • プロダクト: Navigation SDK for iOS
  • 別名: Navigation SDK
  • カテゴリ: ルート
  • プラットフォーム: iOS
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Navigation SDK for iOS の概要
  • 対象地域: 制限あり。車と徒歩経路の経路はほとんどの国で利用できます。交通状況、リアルタイムの交通障害、オートバイ、サイクリング、制限速度、信号機、一時停止標識は国によって異なります。(カバレッジの詳細)

Navigation SDK for iOS: 使用するタイミング

Navigation SDK for iOS を使用するケース:

  • ユーザーがアプリを切り替える必要がないように、独自のネイティブ iOS アプリ内に Google マップのターンバイターン方式ナビを組み込む必要があります。
  • 案内中にブランドに合わせてナビゲーション UI、地図のスタイル、カメラ、レイアウトをカスタマイズする必要がある。
  • ルート設定、複数のウェイポイント、または Routes API か Route Optimization API のルートトークンが必要です。
  • カスタム ガイダンス UI または CarPlay に、ルートイベント(位置情報、到着、ルート変更、到着予定時刻)またはターンバイターン データフィードが必要な場合。

Navigation SDK for iOS を使用しない場合:

  • Android アプリを構築している場合は、代わりに Navigation SDK for Android を使用してください。
  • Flutter アプリまたは React Native アプリを構築している場合は、代わりに Flutter および React Native 向け Google Navigation を使用してください。
  • サーバー上のルート、到着予定時刻、距離のみが必要で、アプリ内ガイダンスは必要ありません。代わりに Routes API を使用してください。

Navigation SDK for iOS: 設定

Navigation SDK for iOS の公式パッケージ:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

Navigation SDK for iOS で使用できないパッケージ:

  • cocoapods: GoogleNavigation。CocoaPods ディストリビューションはバージョン 11.0.0 で非推奨となり、2025 年 8 月 18 日にメンテナンス モードに移行しました。代わりに Swift Package Manager を使用してください。

Navigation SDK for iOS: よくある間違い

  • 問題: SDK が iOS のアイドル タイマーを無効にしないため、ナビゲーション中に画面が暗くなるか、オフになります。修正: ナビゲーション中に UIApplication.shared.isIdleTimerDisabled = true を設定します。/maps/documentation/navigation/ios-sdk/route をご覧ください。
  • 問題: SDK の今後のメジャー リリースでは、高度計(CMAltimeter)が使用されます。Info.plist に NSMotionUsageDescription がないアプリは、初期化時にクラッシュします。現時点でキーを追加しても、現在の動作には影響しません。修正方法: NSMotionUsageDescription(Privacy - Motion Usage Description)を Info.plist に追加します。/maps/documentation/navigation/ios-sdk/route をご覧ください。
  • 問題: Places SDK for iOS が Navigation SDK にバンドルされていないため(Places SDK 5.0 以降)、Places クラスがありません。修正: Places SDK for iOS を、Navigation SDK と同じバージョンで別途インストールします。/maps/documentation/navigation/ios-sdk/xcode-setup をご覧ください。
  • 問題: アプリの travelMode が driving または twoWheeler でない場合、ルートトークンを使用した目的地の設定が .travelModeUnsupported で失敗します。修正方法: mapView.travelMode を .driving または .twoWheeler に設定します。resolvedParameters.travelMode を確認して、ルートで使用されているモードを確認します。/maps/documentation/navigation/ios-sdk/route-customizations をご覧ください。

Navigation SDK for iOS: 以前の機能と非推奨の機能

  • CocoaPods ディストリビューション: 2026 年 8 月 6 日以降非推奨。代替手段: Swift Package Manager。症状: 2025 年 8 月 18 日以降、メンテナンス モードになっています。2026 年第 2 四半期以降、CocoaPods の新しいバージョンはリリースされません。移行ガイドをご覧ください。
  • GMSNavigator setDestinations:callback:、setDestinations:routingOptions:callback:、setDestinations:routeToken:callback:(GMSRouteStatusCallback): 2026 年 11 月 2 日以降非推奨。交換: setDestinations:completionHandler:、setDestinations:routingOptions:completionHandler:、setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler)。
  • GMSServices インスタンス プロパティ appCheckTokenProvider: 2026 年 9 月 24 日以降非推奨。代替: クラス プロパティ GMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:])。症状: 11.1.0 では、GMSServices.sharedServices() を介した App Check の構成に失敗しました。移行ガイドをご覧ください。
  • GMSNavigator continueToNextDestination: 2026 年 4 月 7 日以降非推奨。交換: GMSNavigator continueToNextDestinationWithCompletion:。
  • GMSUISettings showsTrafficLights、showsStopSigns: 2026 年 8 月 6 日以降廃止。代替機能: 代替機能は必要ありません。ナビゲーション中に信号機と一時停止標識がデフォルトで表示されます。
  • .terrain ナビゲーション中の地図タイプ: 2026 年 8 月 6 日をもって廃止。代替: .normal(kGMSTypeNormal)、.satellite、.hybrid のいずれかの地図タイプ。
  • GMSNavigatorDelegate プロトコルと GMSRoadSnappedLocationProviderDelegate プロトコル: 2021 年 5 月 13 日以降廃止。代替: GMSNavigatorListener と GMSRoadSnappedLocationProviderListener(-addListener: で追加、GMSNavigator で timeUpdateThreshold と distanceUpdateThreshold を設定)。移行ガイドをご覧ください。

Navigation SDK for iOS でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。

Navigation SDK for iOS: 地図のスタイル設定

Navigation SDK for iOS: ナビゲーション