このガイドでは、Navigation SDK for Android を使用して、アプリ内の 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 Navigation 利用規約に同意する必要があります。この承認が必要なのは 1 回のみです。デフォルトでは、ナビゲータが初めて呼び出されたときに、承認を求めるメッセージが SDK に表示されます。ナビゲーション利用規約ダイアログは、登録時やログイン時など、アプリの UX フローの早い段階で
showTermsAndConditionsDialog()
を使用してトリガーできます。 - 緯度と経度の目的地ではなくプレイス ID を使用して地点を初期化すると、ナビゲーションの品質と到着予定時刻の精度が大幅に向上します。
- このサンプルでは、特定のプレイス ID(シドニー オペラハウスの)から目的地の地点を取得します。他の特定のビジネスのプレイス ID を取得するには、プレイス ID 検索ツールをご利用ください。または、アプリに Place Picker を追加して、ユーザーが目的地を選択できるようにすることもできます。Navigation SDK でプレイス選択ツールの実際のサンプルを試すには、概要で説明されているデモアプリをご覧ください。
次のステップ
1 回の乗車内で複数の目的地に移動する方法を確認する。Google との契約でトランザクションごとの課金が指定されている場合は、課金対象トランザクションを設定します。