このガイドでは、 Android 用 Navigation SDKこのガイドは、 Navigation SDK をアプリに組み込む方法については、 プロジェクトを設定します。
概要
- UI 要素をナビゲーション フラグメントまたは 表示できますこの UI 要素により、インタラクティブな地図とターンバイターン方式の地図が追加されます。 ナビゲーション UI をアクティビティに追加します。
- 位置情報の利用許可をリクエストします。アプリが位置情報の利用許可をリクエストする必要があります デバイスの位置を特定できます
- 以下を使用して SDK を初期化します:
NavigationApi
クラスです。 目的地を設定し、ターンバイターン方式ナビを操作するには、
Navigator
クラスです。これには、次の 3 つのステップがあります。- 次を使用して宛先を設定する:
setDestination()
。 - ナビを開始する方法
startGuidance()
。 getSimulator()
を使用する ルート上の車両の進行状況をシミュレートできます。 を使用してアプリのテスト、デバッグ、デモを行います。
- 次を使用して宛先を設定する:
アプリをビルドして実行します。
コードの確認
アプリに UI 要素を追加する
このセクションでは、インタラクティブな地図と UI を ターンバイターン方式ナビを表示しています。
ナビゲーション フラグメントを使用する
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 の権限。
Android で権限を
<manifest>
要素の子として追加する manifest:<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 Cloud リソースを使用することを
ナビゲーションです。このセクションでは、ナビゲータの初期化方法と、
アプリで有効にできる他の構成:
Navigation SDK を初期化して、 ナビゲータの起動時にナビゲーションを開始する
onNavigatorReady()
コールバック 確認します。省略可。ガイダンス通知とバックグラウンド処理を行うようにアプリを構成する ユーザーがデバイスからアプリを閉じるとシャットダウンします。この どの選択肢を選ぶかはビジネスモデルによって異なります。デフォルトの ナビゲータの動作(曲がり角の案内と位置情報を表示し続けます) アプリは閉じても更新されません。シャットダウンしたい場合は、 エンドユーザーがアプリを閉じたときに、ナビゲーションと位置情報の更新を この構成を使用します
省略可。サポートされている国で道路規制を有効にする。最後を設定 ナンバー プレートの桁数。この呼び出しは 1 回だけ行う必要があります。 ルート リクエストでは引き続きその値が使用されます。この通話はサポートされている あります。詳しくは、 Navigation SDK のサポート対象国。
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。 エミュレータを指定する際は、必ず次の要素を含むイメージを選択してください。 説明します。
- Android Studio で [Run] メニュー オプションまたはプレイボタン アイコンをクリックします。 表示される指示に沿ってデバイスを選択します。
ユーザー エクスペリエンスを向上させるためのヒント
- ユーザーは、事前に Google ナビゲーション利用規約に同意する必要があります。
ナビゲーションが利用可能になりますこの同意が必要となるのは 1 回のみです。方法
デフォルトでは、ナビゲータを初めて起動したときに、
呼び出すことができます。必要に応じて、ナビゲーションの利用規約ダイアログを表示することもできます
アプリの UX フローの初期段階(登録時やログイン時など)に、
TermsAndConditionsCheckOption
。 - ナビゲーションの質と ETA の精度を大幅に向上させるには、以下を使用します。 場所 ID を使用して、緯度と経度ではなくウェイポイントを初期化する 指定します。
- このサンプルでは、特定のプレイス ID から目的地のウェイポイントを取得しています。 シドニー オペラハウスです。こちらの プレイス ID 検索 その他の特定の場所のプレイス ID です。