Mengubah UI navigasi

Dengan Navigation SDK for Android, Anda dapat mengubah pengalaman pengguna dengan peta dengan menentukan kontrol dan elemen UI bawaan mana yang muncul di peta. Anda juga dapat menyesuaikan tampilan visual UI navigasi. Lihat halaman Kebijakan untuk mendapatkan panduan tentang perubahan yang dapat diterima pada UI navigasi.

Dokumen ini menjelaskan cara mengubah antarmuka pengguna peta dengan dua cara:

• Kontrol UI peta
• Aksesori UI peta

Catatan: Dalam sebagian besar kasus, sebaiknya gunakan SupportNavigationFragment, yang merupakan wrapper untuk NavigationView, bukan berinteraksi langsung dengan NavigationView. Untuk informasi selengkapnya, lihat Praktik terbaik interaksi peta navigasi .

Perhatian: Android Navigation SDK tidak mendukung gaya visual peta berbasis cloud dengan ID peta.

Kontrol UI peta

Kontrol UI peta berada di atas tampilan navigasi. Navigation SDK untuk Android akan otomatis memosisikan ulang kontrol kustom Anda saat tata letak bawaan berubah. Untuk setiap posisi tata letak, Anda dapat menetapkan satu kontrol kustom. Kontrol kustom dapat berupa satu elemen UI atau, jika desain Anda memerlukan lebih banyak, Anda dapat menggunakan ViewGroup dengan beberapa elemen UI.

Metode setCustomControl memberikan posisi seperti yang ditentukan dalam enum CustomControlPosition:

• SECONDARY_HEADER (hanya muncul dalam mode potret)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW

Misalnya, gambar di bawah menunjukkan contoh berbagai posisi kontrol UI yang memberi tahu pengemudi transportasi online tentang lokasi penumpang selama penjemputan.

Menambahkan header sekunder kustom

Secara default, tata letak layar dalam mode navigasi menyediakan posisi untuk header sekunder yang terletak di bawah header utama. Header sekunder ini muncul jika diperlukan, seperti dengan panduan jalur. Aplikasi Anda dapat menggunakan posisi header sekunder tata letak ini untuk konten kustom. Saat Anda menggunakan fitur ini, kontrol Anda akan mencakup konten header sekunder default. Jika tampilan navigasi Anda memiliki latar belakang, latar belakang tersebut akan tetap berada di tempatnya, yang ditutupi oleh header sekunder. Jika aplikasi Anda menghapus kontrol kustom, header sekunder default apa pun dapat muncul di tempatnya.

Posisi header sekunder kustom menyejajarkan tepi atas dengan tepi bawah header utama. Posisi ini hanya didukung dalam bahasa portrait mode. Di landscape mode, header sekunder tidak tersedia, dan tata letak tidak berubah.

1. Buat Android View dengan elemen UI kustom atau ViewGroup.
2. Infasikan XML atau buat instance tampilan kustom untuk mendapatkan instance tampilan yang akan ditambahkan sebagai header sekunder.

3. Gunakan NavigationView.setCustomControl atau SupportNavigationFragment.setCustomControl dengan CustomControlPosition sebagai SECONDARY_Header.

   Catatan: Aplikasi Anda harus memanggil metode ini di UI thread.

   Contoh di bawah membuat fragmen dan menambahkan kontrol kustom di posisi header sekunder.

   Catatan: Kode dalam contoh memiliki jeda baris agar terlihat dalam dokumentasi. Pastikan untuk menghapusnya jika perlu.

    mNavFragment.setCustomControl(getLayoutInflater().
      inflate(R.layout.your_custom_control, null),
      CustomControlPosition.SECONDARY_HEADER);
    ```
   

Menghapus header sekunder

Untuk menghapus header sekunder dan kembali ke konten default, gunakan metode setCustomControl.

Tetapkan tampilan ke null untuk menghapus tampilan.

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Menambahkan kontrol kustom ke bagian bawah tampilan navigasi

Aplikasi Anda dapat menentukan kontrol kustom yang disejajarkan dengan tepi bawah tampilan navigasi. Saat aplikasi Anda menambahkan kontrol kustom, tombol kembali ke tengah dan logo Google akan naik untuk mengakomodasinya.

1. Buat Android View dengan elemen UI atau kelompok tampilan yang ingin ditambahkan.
2. Buat tampilan atau fragmen navigasi.
3. Panggil metode setCustomControl pada tampilan navigasi atau fragmen, dan tentukan kontrol dan posisi yang akan digunakan.

Catatan: Aplikasi Anda harus memanggil metode ini di thread UI.

Contoh berikut menunjukkan View kustom yang ditambahkan ke SupportNavigationFragment:

private SupportNavigationFragment mNavFragment;
mNavFragment = (SupportNavigationFragment)
  getFragmentManager().findFragmentById(R.id.navigation_fragment);

// Create the custom control view.
MyCustomView myCustomView = new MyCustomView();

// Add the custom control to the bottom end corner of the layout.
mNavFragment.setCustomControl(myCustomView, CustomControlPosition.
  BOTTOM_END_BELOW);

Menghapus kontrol kustom

Untuk menghapus kontrol kustom, gunakan metode setCustomControl dan tentukan posisi kontrol yang ingin Anda hapus.

Tetapkan tampilan ke null untuk posisi tersebut.

mNavFragment.setCustomControl(null, CustomControlPosition.BOTTOM_END_BELOW);

Aksesori UI peta

Navigation SDK untuk Android menyediakan aksesori UI yang muncul selama navigasi serupa dengan yang ditemukan di aplikasi Google Maps untuk Android. Anda dapat menyesuaikan visibilitas atau tampilan visual kontrol ini seperti yang dijelaskan di bagian ini. Perubahan yang Anda buat di sini akan tercermin selama sesi navigasi berikutnya.

Lihat halaman Kebijakan untuk mengetahui panduan tentang modifikasi yang dapat diterima pada UI navigasi.

Melihat kode

Tampilkan/Sembunyikan kode Java untuk aktivitas navigasi.

package com.example.navsdkcustomization;

import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.CameraPerspective;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.Navigator;
import com.google.android.libraries.navigation.SimulationOptions;
import com.google.android.libraries.navigation.StylingOptions;
import com.google.android.libraries.navigation.SupportNavigationFragment;
import com.google.android.libraries.navigation.Waypoint;

/** An activity that displays a map and a customized navigation UI. */
public class NavigationActivityCustomization extends AppCompatActivity {

  private static final String TAG = NavigationActivityCustomization.class.getSimpleName();
  private Navigator mNavigator;
  private SupportNavigationFragment mNavFragment;
  private GoogleMap mMap;
  // Define the Sydney Opera House by specifying its place ID.
  private static final String SYDNEY_OPERA_HOUSE = "ChIJ3S-JXmauEmsRUcIaWtf4MzE";
  // Set fields for requesting location permission.
  private static final int PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1;
  private boolean mLocationPermissionGranted;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Navigation SDK.
    initializeNavigationSdk();
  }

  /**
   * Starts the Navigation SDK and sets the camera to follow the device's location. Calls the
   * navigateToPlace() method when the navigator is ready.
   */
  private void initializeNavigationSdk() {
    /*
     * Request location permission, so that we can get the location of the
     * device. The result of the permission request is handled by a callback,
     * onRequestPermissionsResult.
     */
    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;
    }

    // Get a navigator.
    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 =
                (SupportNavigationFragment)
                    getSupportFragmentManager().findFragmentById(R.id.navigation_fragment);

            // Get the map.
            mNavFragment.getMapAsync(
                new OnMapReadyCallback() {
                  @Override
                  public void onMapReady(GoogleMap map) {
                    mMap = map;
                    // Navigate to a place, specified by Place ID.
                    navigateToPlace(SYDNEY_OPERA_HOUSE);
                  }
                });
          }

          /**
           * 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);
            }
          }
        });
  }

  /** Customizes the navigation UI and the map. */
  private void customizeNavigationUI() {
    // Set custom colors for the navigator.
    mNavFragment.setStylingOptions(
        new StylingOptions()
            .primaryDayModeThemeColor(0xff1A237E)
            .secondaryDayModeThemeColor(0xff3F51B5)
            .primaryNightModeThemeColor(0xff212121)
            .secondaryNightModeThemeColor(0xff424242)
            .headerLargeManeuverIconColor(0xffffff00)
            .headerSmallManeuverIconColor(0xffffa500)
            .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerNextStepTextColor(0xff00ff00)
            .headerNextStepTextSize(20f)
            .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
            .headerDistanceValueTextColor(0xff00ff00)
            .headerDistanceUnitsTextColor(0xff0000ff)
            .headerDistanceValueTextSize(20f)
            .headerDistanceUnitsTextSize(18f)
            .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerInstructionsTextColor(0xffffff00)
            .headerInstructionsFirstRowTextSize(24f)
            .headerInstructionsSecondRowTextSize(20f)
            .headerGuidanceRecommendedLaneColor(0xffffa500));

    mMap.setTrafficEnabled(false);

    // Place a marker at the final destination.
    if (mNavigator.getCurrentRouteSegment() != null) {
      LatLng destinationLatLng = mNavigator.getCurrentRouteSegment().getDestinationLatLng();

      Bitmap destinationMarkerIcon =
          BitmapFactory.decodeResource(getResources(), R.drawable.ic_person_pin_48dp);

      mMap.addMarker(
          new MarkerOptions()
              .position(destinationLatLng)
              .icon(BitmapDescriptorFactory.fromBitmap(destinationMarkerIcon))
              .title("Destination marker"));

      // Listen for a tap on the marker.
      mMap.setOnMarkerClickListener(
          new GoogleMap.OnMarkerClickListener() {
            @Override
            public boolean onMarkerClick(Marker marker) {
              displayMessage(
                  "Marker tapped: "
                      + marker.getTitle()
                      + ", at location "
                      + marker.getPosition().latitude
                      + ", "
                      + marker.getPosition().longitude);

              // The event has been handled.
              return true;
            }
          });
    }

    // Set the camera to follow the device location with 'TILTED' driving view.
    mMap.followMyLocation(CameraPerspective.TILTED);
  }

  /**
   * Requests directions from the user's current location to a specific place (provided by the
   * Google Places API).
   */
  private void navigateToPlace(String placeId) {
    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);

    // 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();
                }

                // Customize the navigation UI.
                customizeNavigationUI();

                // 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));
            }
          }
        });
  }

  /** Handles the result of the request for location permissions. */
  @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;
          }
        }
    }
  }

  /**
   * Shows a message on screen and in the log. Used when something goes wrong.
   *
   * @param errorMessage The message to display.
   */
  private void displayMessage(String errorMessage) {
    Toast.makeText(this, errorMessage, Toast.LENGTH_LONG).show();
    Log.d(TAG, errorMessage);
  }
}

Mengubah header navigasi

Gunakan SupportNavigationFragment.setStylingOptions() atau NavigationView.setStylingOptions() untuk mengubah tema header navigasi dan indikator belokan berikutnya yang muncul di bawah header jika tersedia.

Anda dapat menetapkan atribut berikut:

Jenis Atribut	Atribut
Warna latar belakang	Mode hari utama - warna siang hari dari header navigasi Mode siang sekunder - warna siang hari dari indikator belokan berikutnya Mode malam utama - warna malam dari header navigasi Mode malam sekunder - warna malam dari indikator belokan berikutnya
Elemen teks untuk petunjuk	Warna teks Font Ukuran teks baris pertama Ukuran teks baris kedua
Elemen teks untuk langkah berikutnya	Font Warna teks nilai jarak Ukuran teks nilai jarak Warna teks satuan jarak Ukuran teks unit jarak
Ikon manuver	Warna ikon manuver besar Warna ikon manuver kecil
Panduan jalur	Warna lajur atau lajur yang direkomendasikan

Contoh berikut menunjukkan cara menetapkan opsi gaya:

private SupportNavigationFragment mNavFragment;
mNavFragment = (SupportNavigationFragment) getFragmentManager()
  .findFragmentById(R.id.navigation_fragment);

// Set the styling options on the fragment.
mNavFragment.setStylingOptions(new StylingOptions()
  .primaryDayModeThemeColor(0xff1A237E)
  .secondaryDayModeThemeColor(0xff3F51B5)
  .primaryNightModeThemeColor(0xff212121)
  .secondaryNightModeThemeColor(0xff424242)
  .headerLargeManeuverIconColor(0xffffff00)
  .headerSmallManeuverIconColor(0xffffa500)
  .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerNextStepTextColor(0xff00ff00)
  .headerNextStepTextSize(20f)
  .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
  .headerDistanceValueTextColor(0xff00ff00)
  .headerDistanceUnitsTextColor(0xff0000ff)
  .headerDistanceValueTextSize(20f)
  .headerDistanceUnitsTextSize(18f)
  .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerInstructionsTextColor(0xffffff00)
  .headerInstructionsFirstRowTextSize(24f)
  .headerInstructionsSecondRowTextSize(20f)
  .headerGuidanceRecommendedLaneColor(0xffffa500));

Menonaktifkan lapisan lalu lintas

Gunakan GoogleMap.setTrafficEnabled() untuk mengaktifkan atau menonaktifkan lapisan lalu lintas pada peta. Setelan ini memengaruhi indikasi kepadatan lalu lintas yang ditampilkan di peta secara keseluruhan. Namun, hal ini tidak memengaruhi indikasi lalu lintas di rute yang dipetakan oleh navigator.

private GoogleMap mMap;
// Get the map, and when the async call returns, setTrafficEnabled
// (callback will be on the UI thread)
mMap = mNavFragment.getMapAsync(navMap -> navMap.setTrafficEnabled(false));

Mengaktifkan lampu lalu lintas dan rambu berhenti

Anda dapat mengaktifkan lampu lalu lintas dan rambu berhenti di UI peta. Dengan fitur ini, pengguna dapat mengaktifkan tampilan lampu lalu lintas atau ikon tanda berhenti di sepanjang rute mereka, sehingga memberikan konteks yang lebih baik untuk perjalanan yang lebih efisien dan akurat.

Secara default, lampu lalu lintas dan rambu berhenti dinonaktifkan di Navigation SDK. Untuk mengaktifkan fitur ini, panggil DisplayOptions untuk setiap fitur secara terpisah.

Catatan: Lampu lalu lintas dan rambu berhenti hanya dapat ditampilkan selama navigasi aktif.

DisplayOptions displayOptions =
  new DisplayOptions().showTrafficLights(true).showStopSigns(true);

Menambahkan penanda kustom

Navigation SDK for Android kini menggunakan Google Maps API untuk penanda. Buka dokumentasi Maps API untuk mengetahui informasi selengkapnya.

Teks mengambang

Anda dapat menambahkan teks mengambang di mana saja dalam aplikasi, asalkan teks tersebut tidak mencakup atribusi Google. Navigation SDK tidak mendukung anchor teks ke lintang/bujur pada peta, atau ke label. Buka Jendela info untuk mengetahui informasi selengkapnya.

Menampilkan batas kecepatan

Anda dapat menampilkan atau menyembunyikan ikon batas kecepatan secara terprogram. Gunakan NavigationView.setSpeedLimitIconEnabled() atau SupportNavigationFragment.setSpeedLimitIconEnabled() untuk menampilkan atau menyembunyikan ikon batas kecepatan. Jika diaktifkan, ikon batas kecepatan akan ditampilkan di sudut bawah selama panduan. Ikon ini menampilkan batas kecepatan jalan yang dilalui kendaraan. Ikon ini hanya muncul di lokasi tempat data batas kecepatan yang andal tersedia.

 // Display the Speed Limit icon
 mNavFragment.setSpeedLimitIconEnabled(true);

Ikon batas kecepatan disembunyikan sementara saat tombol kembali ke tengah ditampilkan.

Catatan: Pengguna harus mematuhi semua rambu yang dipasang di jalan. Data yang diposting di ikon batas kecepatan hanya berfungsi sebagai referensi. Akurasi data batas kecepatan tidak dapat dijamin. Anda dapat melaporkan ketidakakuratan dalam data batas kecepatan kami dengan mengajukan kasus di halaman Dukungan Google Cloud.

Setel mode malam

Anda dapat mengontrol perilaku mode malam secara terprogram. Gunakan NavigationView.setForceNightMode() atau SupportNavigationFragment.setForceNightMode() untuk mengaktifkan atau menonaktifkan mode malam, atau biarkan Navigation SDK for Android mengontrolnya.

• AUTO Memungkinkan Navigation SDK menentukan mode yang sesuai berdasarkan lokasi perangkat dan waktu setempat.
• FORCE_NIGHT memaksa mode malam aktif.
• FORCE_DAY memaksa mode siang aktif.

Contoh berikut menunjukkan cara memaksa mode malam untuk diaktifkan dalam fragmen navigasi:

// Force night mode on.
mNavFragment.setForceNightMode(FORCE_NIGHT);

Menampilkan daftar rute

Pertama, buat tampilan dan tambahkan ke hierarki Anda.

void setupDirectionsListView() {
  // Create the view.
  DirectionsListView directionsListView = new DirectionsListView(getApplicationContext());
  // Add the view to your view hierarchy.
  ViewGroup group = findViewById(R.id.directions_view);
  group.addView(directionsListView);

  // Add a button to your layout to close the directions list view.
  ImageButton button = findViewById(R.id.close_directions_button); // this button is part of the container we hide in the next line.
  button.setOnClickListener(
      v -> findViewById(R.id.directions_view_container).setVisibility(View.GONE));
}

Pastikan untuk meneruskan peristiwa siklus proses ke DirectionsListView seperti halnya dengan NavigationView. Contoh:

protected void onResume() {
  super.onResume();
  directionsListView.onResume();
}

Menyembunyikan rute alternatif

Peringatan: Fitur ini saat ini tidak kompatibel dengan fitur rute terdekat/tercepat. Menggunakan kedua fitur secara bersamaan dapat menghasilkan perilaku yang tidak terduga.

Jika antarmuka pengguna menjadi berantakan karena terlalu banyak informasi, Anda dapat mengurangi kekacauan dengan menampilkan lebih sedikit rute alternatif daripada rute default (dua), atau dengan tidak menampilkan rute alternatif sama sekali. Anda dapat mengonfigurasi opsi ini sebelum mengambil rute dengan memanggil metode RoutingOptions.alternateRoutesStrategy() menggunakan salah satu nilai enumerasi berikut:

Nilai Enumerasi	Deskripsi
AlternateRoutesStrategy.SHOW_ALL	Default. Menampilkan hingga dua rute alternatif.
AlternateRoutesStrategy.SHOW_ONE	Menampilkan satu rute alternatif (jika tersedia).
AlternateRoutesStrategy.SHOW_NONE	Menyembunyikan rute alternatif.

Contoh kode berikut menunjukkan cara menyembunyikan rute alternatif secara keseluruhan.

RoutingOptions routingOptions = new RoutingOptions();
routingOptions.alternateRoutesStrategy(AlternateRoutesStrategy.SHOW_NONE);
navigator.setDestinations(destinations, routingOptions, displayOptions);

Status progres perjalanan

Status progres perjalanan adalah status progres vertikal yang muncul di tepi kanan peta saat navigasi dimulai. Jika diaktifkan, halaman ini akan menampilkan ringkasan untuk seluruh perjalanan, beserta tujuan dan posisi pengguna saat ini.

Pengguna dapat dengan cepat mengantisipasi masalah yang akan terjadi, seperti traffic, tanpa perlu memperbesarnya. Kemudian, mereka dapat mengubah rute perjalanan jika perlu. Jika pengguna mengubah rute perjalanan, status progres akan direset seolah-olah perjalanan baru telah dimulai dari titik tersebut.

Status progres perjalanan menampilkan indikator status berikut:

• Rute yang telah dilalui—bagian perjalanan yang telah dilalui.

• Posisi saat ini—lokasi pengguna saat ini dalam perjalanan.

• Status traffic—status traffic mendatang.

• Tujuan akhir—tujuan perjalanan akhir.

Catatan: Status progres perjalanan hanya terlihat dalam mode potret.

Aktifkan status progres perjalanan dengan memanggil metode setTripProgressBarEnabled() di NavigationView atau SupportNavigationFragment. Contoh:

// Enable the trip progress bar.
mNavFragment.setTripProgressBarEnabled(true);