このガイドでは、Android 用の Navigation SDK を使用して、アプリ内で 1 つのデスティネーションへのルートをプロットする方法を説明します。
概要
- 構成ガイドの説明に沿って、Navigation SDK をアプリに統合します。
NavigationFragment
またはNavigationView
をアプリに追加します。この UI 要素により、インタラクティブな地図とターンバイターン ナビゲーション UI がアクティビティに追加されます。NavigationApi
クラスを使用して SDK を初期化します。ターンバイターン方式のナビゲーションを制御するために
Navigator
を定義します。setDestination()
を使用してデスティネーションを追加します。startGuidance()
でナビを開始します。getSimulator()
を使用してルート上の車両の進行状況をシミュレートし、アプリのテスト、デバッグ、デモを行います。
アプリをビルドして実行します。
コードの確認
ナビゲーション フラグメントを追加する
NavigationFragment
は、インタラクティブな地図やターンバイターンのルート案内など、ナビゲーションの視覚的な出力を表示する UI コンポーネントです。次のように、XML レイアウト ファイル内でフラグメントを宣言できます。
<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
android:name="com.google.android.libraries.navigation.NavigationFragment"
android:id="@+id/navigation_fragment"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
または、Android のドキュメントに記載されているように、フラグメントをプログラマティックに作成することもできます。
Fragment
のサポート バージョンを使用しているアプリの場合、Navigation SDK は SupportNavigationFragment
を通じて互換性を提供します。このフラグメントは NavigationFragment
と同じように動作し、FragmentActivity.getSupportFragmentManager()
を使用してプログラムで管理できます。
フラグメントの代わりに、UI コンポーネントは NavigationView
としても利用できます。クラスの説明の一番上に記載されている情報に注意してください。特に、ライフサイクル メソッドを転送する要件に関する情報に注意してください。
位置情報の利用許可をリクエストする
デバイスの位置を特定するには、アプリで位置情報の利用許可をリクエストする必要があります。
このチュートリアルでは、精度の高い位置情報の利用許可をリクエストするためのコードを提供します。詳しくは、Android の権限に関するガイドをご覧ください。
権限を
<manifest>
要素の子要素として Android マニフェストに追加します。<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.navsdksingledestination"> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> </manifest>
アプリで実行時の権限をリクエストして、ユーザーが位置情報の利用許可を許可または拒否できるようにします。ユーザーが精度の高い位置情報の利用許可を付与しているかどうかは、次のコードで確認できます。許可していない場合は、パーミッションをリクエストします。
if (ContextCompat.checkSelfPermission(this.getApplicationContext(), android.Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { mLocationPermissionGranted = true; } else { ActivityCompat.requestPermissions(this, new String[] { android.Manifest.permission.ACCESS_FINE_LOCATION }, PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION); } if (!mLocationPermissionGranted) { displayMessage("Error loading Navigation SDK: " + "The user has not granted location permission."); return; }
onRequestPermissionsResult()
コールバックをオーバーライドして、権限リクエストの結果を処理します。@Override public void onRequestPermissionsResult(int requestCode, @NonNull String permissions[], @NonNull int[] grantResults) { mLocationPermissionGranted = false; switch (requestCode) { case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION: { // If request is canceled, the result arrays are empty. if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { mLocationPermissionGranted = true; } } } }
Navigation SDK を初期化してジャーニーを構成する
NavigationApi
クラスは初期化ロジックを提供し、アプリに Google ナビゲーションの使用を許可します。Navigator
クラスを使用すると、ナビゲーション ジャーニーの構成、開始/停止を制御できます。
Navigation SDK を初期化し、
onNavigatorReady()
コールバックをオーバーライドして、ナビゲータの準備ができたらナビゲーションを開始するようにします。(省略可)サポートされている国(現在はブラジルとインドネシア)で道路規制を有効にするには、ナンバー プレートの最後の桁を設定します。この呼び出しが他の国コードに使用される場合、API はこれを無視します。この呼び出しは 1 回だけ行う必要があります。後続のルート リクエストでは、引き続きこのオブジェクトが使用されます。
NavigationApi.getNavigator(this, new NavigationApi.NavigatorListener() { /** * Sets up the navigation UI when the navigator is ready for use. */ @Override public void onNavigatorReady(Navigator navigator) { displayMessage("Navigator ready."); mNavigator = navigator; mNavFragment = (NavigationFragment) getFragmentManager() .findFragmentById(R.id.navigation_fragment); // Set the last digit of the car's license plate to get route restrictions // in supported countries. (optional) // mNavigator.setLicensePlateRestrictionInfo(getLastDigit(), "BZ"); // Set the camera to follow the device location with 'TILTED' driving view. mNavFragment.getCamera().followMyLocation(Camera.Perspective.TILTED); // Set the travel mode (DRIVING, WALKING, CYCLING, TWO_WHEELER, or TAXI). mRoutingOptions = new RoutingOptions(); mRoutingOptions.travelMode(RoutingOptions.TravelMode.DRIVING); // Navigate to a place, specified by Place ID. navigateToPlace(SYDNEY_OPERA_HOUSE, mRoutingOptions); } /** * Handles errors from the Navigation SDK. * @param errorCode The error code returned by the navigator. */ @Override public void onError(@NavigationApi.ErrorCode int errorCode) { switch (errorCode) { case NavigationApi.ErrorCode.NOT_AUTHORIZED: displayMessage("Error loading Navigation SDK: Your API key is " + "invalid or not authorized to use the Navigation SDK."); break; case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED: displayMessage("Error loading Navigation SDK: User did not accept " + "the Navigation Terms of Use."); break; case NavigationApi.ErrorCode.NETWORK_ERROR: displayMessage("Error loading Navigation SDK: Network error."); break; case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING: displayMessage("Error loading Navigation SDK: Location permission " + "is missing."); break; default: displayMessage("Error loading Navigation SDK: " + errorCode); } } });
上記で取得した
Navigator
を使用して、このジャーニーの目的地Waypoint
を設定します。ルートを計算すると、NavigationFragment
により、ルートを表すポリラインと目的地のマーカーが地図上に表示されます。private void navigateToPlace(String placeId, RoutingOptions travelMode) { Waypoint destination; try { destination = Waypoint.builder().setPlaceIdString(placeId).build(); } catch (Waypoint.UnsupportedPlaceIdException e) { displayMessage("Error starting navigation: Place ID is not supported."); return; } // Create a future to await the result of the asynchronous navigator task. ListenableResultFuture<Navigator.RouteStatus> pendingRoute = mNavigator.setDestination(destination, travelMode); // Define the action to perform when the SDK has determined the route. pendingRoute.setOnResultListener( new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() { @Override public void onResult(Navigator.RouteStatus code) { switch (code) { case OK: // Hide the toolbar to maximize the navigation UI. if (getActionBar() != null) { getActionBar().hide(); } // Enable voice audio guidance (through the device speaker). mNavigator.setAudioGuidance( Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE); // Simulate vehicle progress along the route for demo/debug builds. if (BuildConfig.DEBUG) { mNavigator.getSimulator().simulateLocationsAlongExistingRoute( new SimulationOptions().speedMultiplier(5)); } // Start turn-by-turn guidance along the current route. mNavigator.startGuidance(); break; // Handle error conditions returned by the navigator. case NO_ROUTE_FOUND: displayMessage("Error starting navigation: No route found."); break; case NETWORK_ERROR: displayMessage("Error starting navigation: Network error."); break; case ROUTE_CANCELED: displayMessage("Error starting navigation: Route canceled."); break; default: displayMessage("Error starting navigation: " + String.valueOf(code)); } } }); }
アプリをビルドして実行する
- Android デバイスをコンピュータに接続します。instructionsに沿って、Android デバイスでデベロッパー オプションを有効にし、デバイスを検出するようにシステムを設定します(または、Android Virtual Device(AVD)Manager を使用して仮想デバイスを設定することもできます。エミュレータを指定する際は、Google API を含むイメージを選択する必要があります)。
- Android Studio で [Run] メニュー オプション(またはプレイボタン アイコン)をクリックします。表示される指示に沿ってデバイスを選択します。
ユーザー エクスペリエンスを向上させるためのヒント
- ナビゲーションを利用するには、Google ナビゲーション利用規約に同意する必要があります。この同意が必要となるのは 1 回のみです。デフォルトでは、ナビゲータが初めて呼び出されたときに、SDK は承認を求めるプロンプトを表示します。必要に応じて、
showTermsAndConditionsDialog()
を使用して、アプリの UX フローの早い段階で Navigation 利用規約ダイアログをトリガーできます(登録時やログイン時など)。 - 目的地の緯度と経度ではなく、プレイス ID を使って地点を初期化すると、ナビゲーションの品質と到着予定時刻の精度が大幅に向上します。
- このサンプルでは、(シドニー オペラハウスの)特定のプレイス ID から目的地の地点を取得します。プレイス ID 検索ツールを使用すると、他の特定のビジネスのプレイス ID を取得できます。または、アプリに Place Picker を追加して、ユーザーが目的地を選択できるようにすることもできます。Navigation SDK を使った場所選択ツールの実用的なサンプルを試すには、はじめにで説明したデモアプリをご覧ください。
次のステップ
1 つの経路内の複数の目的地に移動する方法を確認します。Google との契約でトランザクションごとの課金が指定されている場合は、請求対象のトランザクションを設定します。