このガイドでは、Navigation SDK for Android を使用してアプリ内でルートをプロットする方法を説明します。このガイドでは、プロジェクトをセットアップするで説明したように、Navigation SDK がすでにアプリに統合されていることを前提としています。
まとめ
- UI 要素をナビゲーション フラグメントまたはナビゲーション ビューとしてアプリに追加します。この UI 要素により、インタラクティブな地図とターンバイターン ナビゲーション UI がアクティビティに追加されます。
- 位置情報の利用許可をリクエストします。デバイスの位置を特定するには、アプリで位置情報の利用許可をリクエストする必要があります。
NavigationApi
クラスを使用して SDK を初期化します。Navigator
クラスを使用して、デスティネーションを設定し、ターンバイターン ナビゲーションを制御します。これには、次の 3 つのステップが含まれます。setDestination()
を使用して宛先を設定します。startGuidance()
でナビゲーションを開始します。- アプリのテスト、デバッグ、デモを行うために、
getSimulator()
を使用してルートに沿った車両の進行をシミュレートします。
アプリをビルドして実行します。
コードの確認
アプリに UI 要素を追加する
このセクションでは、ターンバイターン方式のナビゲーションを表示するためのインタラクティブな地図と UI を追加する 2 つの方法について説明します。
ナビゲーション フラグメントを使用する
SupportNavigationFragment
は、インタラクティブな地図やターンバイターン方式の経路案内など、ナビゲーションのビジュアル出力を表示する 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.SupportNavigationFragment"
android:id="@+id/navigation_fragment"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
または、Android のドキュメントに記載されているとおり、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 ナビゲーションを使用できるように承認する初期化ロジックを提供します。このセクションでは、ナビゲータを初期化する方法と、アプリで有効にできるその他の構成について説明します。
Navigation SDK を初期化し、ナビゲータの準備が整ったときにナビゲーションを開始するように
onNavigatorReady()
コールバックをオーバーライドします。(省略可)ユーザーがデバイスからアプリを閉じたときに、ガイダンス通知とバックグラウンド サービスがシャットダウンするようにアプリを構成します。この選択は、ビジネスモデルによって異なります。デフォルトのナビゲータ動作を使用することをおすすめします。これにより、アプリを閉じても、曲がり角の案内や位置情報の更新内容が表示され続けます。代わりに、エンドユーザーがアプリを閉じたときにナビゲーションと位置情報の更新をシャットダウンする場合は、この構成を使用します。
(省略可)サポート対象の国で通行制限を有効にしてください。ナンバー プレートの最後の桁を設定します。この呼び出しが必要なのは 1 回だけです。後続のルート リクエストは引き続きこの呼び出しを使用します。この呼び出しはサポートされているリージョンでのみ機能します。
Countries and regions supported for two-wheeled vehicles
をご覧ください。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); // Optional. Disable the guidance notifications and shut down the app // and background service when the user closes the app. // mNavigator.setTaskRemovedBehavior(Navigator.TaskRemovedBehavior.QUIT_SERVICE) // Optional. Set the last digit of the car's license plate to get // route restrictions for supported countries. // 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
クラスは、ナビゲーション ジャーニーの構成、開始、停止を制御します。
前のセクションで取得した Navigator
を使用して、この行程の目的地 Waypoint
を設定します。ルートを計算すると、SupportNavigationFragment
によって、ルートを表すポリラインが地図上に表示され、目的地にマーカーが表示されます。
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 デバイスをコンピュータに接続します。ハードウェア デバイス上でアプリを実行する方法の Android Studio の手順に沿って操作するか、Android Virtual Device(AVD)Manager を使用して仮想デバイスを設定することもできます。エミュレータを選択するときは、Google API を含むイメージを選択する必要があります。
- Android Studio で [Run] メニュー オプションまたはプレイボタン アイコンをクリックします。 表示される指示に沿ってデバイスを選択します。
ユーザー エクスペリエンスを向上させるためのヒント
- ナビゲーションが利用可能になる前に、ユーザーは Google Navigation 利用規約に同意する必要があります。この承認が必要なのは 1 回のみです。デフォルトでは、ナビゲータが初めて呼び出されたときに、承認を求めるメッセージが SDK に表示されます。ナビゲーション利用規約ダイアログは、登録時やログイン時など、アプリの UX フローの早い段階で
TermsAndConditionsCheckOption
を使用してトリガーできます。 - ナビゲーションの質と到着予定時刻の精度を大幅に向上させるには、緯度と経度の座標ではなく、プレイス ID を使用してウェイポイントを初期化する必要があります。
- このサンプルでは、シドニー オペラハウスの特定のプレイス ID から目的地の地点を取得します。他の特定のビジネスのプレイス ID を取得するには、プレイス ID 検索ツールをご利用ください。