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: 設定
- 有効にするサービス:
navigationsdk.googleapis.com - 認証: API キー
- 有効化が必要なその他の API: Maps SDK for iOS
- 使用状況アトリビューション:
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:])を呼び出して、使用状況アトリビューション ID を初期化子に追加します。オプトアウトするには、呼び出しを削除するか、空の文字列を渡します。 - スタートガイド: Navigation SDK for iOS を設定する
- リファレンス: Navigation SDK for iOS リファレンス
- 料金: Navigation SDK for iOS の使用量と請求額
- ポリシー: Navigation SDK for iOS のポリシー
- リリースノート: 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: 関連プロダクト
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 の新しいバージョンはリリースされません。移行ガイドをご覧ください。
GMSNavigatorsetDestinations: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 の構成に失敗しました。移行ガイドをご覧ください。GMSNavigatorcontinueToNextDestination: 2026 年 4 月 7 日以降非推奨。交換:GMSNavigatorcontinueToNextDestinationWithCompletion:。GMSUISettingsshowsTrafficLights、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: ナビゲーション
- モバイルアプリにインタラクティブなターンバイターン方式のナビを追加します。
- ターンバイターン方式のナビの目的地を設定する。
- ターンバイターン方式のナビを開始します。
- ルート リクエストの移動手段(車、徒歩、二輪車、タクシー)を指定します。
- ターンバイターン方式のナビのルート設定を変更する。
- ターンバイターン方式のナビで、道路のどちら側に到着するかなど、到着に関する設定を指定します。
- 再利用可能なルートトークンを使用して、ターンバイターン方式ナビの再計画ルートを指定します。
- ターンバイターン方式のナビゲーション セッションからユーザーの到着に関する最新情報を返します。
- ターンバイターン方式のナビゲーション セッションからユーザーの位置情報の更新を返す。
- ターンバイターン方式ナビのセッションから時間と距離の更新情報を返す。
- ターンバイターン方式ナビのセッションからルート変更の更新を返す。
- ターンバイターン方式ナビのセッションから夜間モードの更新を返します。
- ターンバイターン方式のナビゲーション セッションからユーザーの速度の更新を返します。
- ターンバイターン方式ナビ中に表示される UI 要素とコントロールをカスタマイズします。
- ターンバイターン方式のナビに新しい UI 要素を追加する。
- ターンバイターン方式のナビにルートの進行状況インジケーターを追加する。
- ターンバイターン方式のナビ中に表示される地図上の対象物をカスタマイズします。
- ターンバイターン方式のナビに交通状況レイヤを追加する。
- ターンバイターン方式のナビのカメラビューと動作を変更する。
- ターンバイターン方式のナビで、速度計と速度制限のアラートをカスタマイズする。
- ターンバイターン方式ナビのフィードを、ルート上の各操作の一連のメッセージとして返します。
- ターンバイターン方式のナビゲーション フィードで使用するカスタム操作アイコンを指定します。
- CarPlay 向けのインタラクティブなターンバイターン方式のナビを iOS アプリに追加します。プレビュー
- ルート上の交通の乱れについてユーザーに通知する。
- ナビゲーションを開始する前に、ルート上の交通障害を確認できるようにします。
- ユーザーがルート上の障害を報告できるようにする。
- ユーザーがルート上の障害を確認できるようにする。
- カスタムのルート障害報告ボタンを追加する。