رابط کاربری ناوبری را تغییر دهید

با استفاده از کیت توسعه نرم‌افزار ناوبری (Navigation SDK) برای اندروید، می‌توانید با تعیین اینکه کدام یک از کنترل‌ها و عناصر رابط کاربری داخلی روی نقشه ظاهر شوند، تجربه کاربری با نقشه خود را تغییر دهید. همچنین می‌توانید ظاهر بصری رابط کاربری ناوبری را تنظیم کنید. برای دستورالعمل‌های مربوط به تغییرات قابل قبول در رابط کاربری ناوبری، به صفحه سیاست‌ها مراجعه کنید.

این سند نحوه تغییر رابط کاربری نقشه شما را به دو روش شرح می‌دهد:

• کنترل‌های رابط کاربری نقشه
• لوازم جانبی رابط کاربری نقشه

کنترل‌های رابط کاربری نقشه

برای قرار دادن عناصر رابط کاربری سفارشی در نمای ناوبری، از کنترل‌های رابط کاربری نقشه برای موقعیت‌یابی مناسب استفاده کنید. هنگامی که طرح‌بندی داخلی تغییر می‌کند، Navigation SDK برای اندروید به طور خودکار کنترل‌های سفارشی شما را تغییر موقعیت می‌دهد. می‌توانید برای هر موقعیت، یک نمای کنترل سفارشی را در یک زمان تنظیم کنید. اگر طراحی شما به چندین عنصر رابط کاربری نیاز دارد، می‌توانید آنها را در یک ViewGroup قرار دهید و آن را به متد setCustomControl منتقل کنید.

متد setCustomControl موقعیت‌ها را همانطور که در شمارش CustomControlPosition تعریف شده است، ارائه می‌دهد:

• SECONDARY_HEADER (فقط در حالت عمودی نمایش داده می‌شود)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

اضافه کردن یک کنترل سفارشی

1. یک نمای اندروید با عنصر رابط کاربری سفارشی یا ViewGroup ایجاد کنید.
2. XML را inflate کنید یا از view سفارشی نمونه‌سازی کنید تا یک نمونه از view دریافت کنید.

3. از NavigationView.setCustomControl یا SupportNavigationFragment.setCustomControl با موقعیت کنترل سفارشی انتخاب شده از شمارش CustomControlPosition استفاده کنید.

   مثال زیر یک فرگمنت ایجاد می‌کند و یک کنترل سفارشی در موقعیت هدر ثانویه اضافه می‌کند.

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

حذف یک کنترل سفارشی

برای حذف یک کنترل سفارشی، متد setCustomControl را با پارامتر view null و موقعیت کنترل سفارشی انتخاب شده فراخوانی کنید.

برای مثال، قطعه کد زیر هدر ثانویه any custom را حذف کرده و به محتوای پیش‌فرض برمی‌گرداند:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

موقعیت‌های کنترل سفارشی

هدر ثانویه

برای استفاده از این موقعیت کنترل سفارشی، موقعیت CustomControlPosition.SECONDARY_HEADER را به setCustomControl ارسال کنید.

به طور پیش‌فرض، طرح‌بندی‌های صفحه در حالت ناوبری، موقعیتی را برای یک سربرگ ثانویه که در زیر سربرگ اصلی قرار دارد، فراهم می‌کنند. این سربرگ ثانویه در صورت لزوم، مانند راهنمای مسیر، ظاهر می‌شود. برنامه شما می‌تواند از این موقعیت سربرگ ثانویه طرح‌بندی برای محتوای سفارشی استفاده کند. وقتی از این ویژگی استفاده می‌کنید، کنترل شما هر محتوای سربرگ ثانویه پیش‌فرض را پوشش می‌دهد. اگر نمای ناوبری شما دارای پس‌زمینه باشد، آن پس‌زمینه در جای خود باقی می‌ماند و توسط سربرگ ثانویه پوشانده می‌شود. وقتی برنامه شما کنترل سفارشی را حذف می‌کند، هر سربرگ ثانویه پیش‌فرض می‌تواند به جای آن ظاهر شود.

موقعیت سربرگ ثانویه سفارشی، لبه بالایی خود را با لبه پایینی سربرگ اصلی تراز می‌کند. این موقعیت فقط در portrait mode پشتیبانی می‌شود. در landscape mode ، سربرگ ثانویه در دسترس نیست و طرح‌بندی تغییر نمی‌کند.

شروع از پایین

برای استفاده از این موقعیت کنترل سفارشی، موقعیت CustomControlPosition.BOTTOM_START_BELOW را به setCustomControl ارسال کنید.

این کنترل سفارشی در گوشه شروع پایین نقشه قرار می‌گیرد. در هر دو portrait mode و landscape mode ، بالای کارت ETA و/یا پاورقی سفارشی (یا در امتداد پایین نقشه اگر هیچ‌کدام وجود نداشته باشند) قرار می‌گیرد و عناصر Nav SDK شامل دکمه re-center و لوگوی گوگل به سمت بالا حرکت می‌کنند تا ارتفاع نمای کنترل سفارشی را در نظر بگیرند. این کنترل در داخل مرزهای قابل مشاهده نقشه قرار می‌گیرد، بنابراین هر padding که به لبه‌های پایین یا شروع نقشه اضافه شود، موقعیت این کنترل را نیز تغییر می‌دهد.

انتهای پایین

برای استفاده از این موقعیت کنترل سفارشی، موقعیت CustomControlPosition.BOTTOM_END_BELOW را به setCustomControl ارسال کنید.

این کنترل سفارشی در گوشه انتهایی پایین نقشه قرار می‌گیرد. در portrait mode ، بالای کارت ETA و/یا پاورقی سفارشی (یا در امتداد پایین نقشه اگر هیچ‌کدام وجود نداشته باشند) قرار می‌گیرد، اما در landscape mode با پایین نقشه تراز می‌شود. هر عنصر Nav SDK که در امتداد سمت انتهایی (سمت راست در چپ به راست) قابل مشاهده باشد، به سمت بالا حرکت می‌کند تا ارتفاع نمای کنترل سفارشی را در نظر بگیرد. این کنترل در داخل مرزهای قابل مشاهده نقشه قرار می‌گیرد، بنابراین هر padding اضافه شده به لبه‌های پایین یا انتهایی نقشه، موقعیت این کنترل را نیز تغییر می‌دهد.

پاورقی

برای استفاده از این موقعیت کنترل سفارشی، موقعیت CustomControlPosition.FOOTER را به setCustomControl ارسال کنید.

این موقعیت کنترل سفارشی برای نمای پاورقی سفارشی طراحی شده است. اگر کارت Nav SDK ETA قابل مشاهده باشد، این کنترل بالای آن قرار می‌گیرد. در غیر این صورت، کنترل با پایین نقشه تراز می‌شود. برخلاف کنترل‌های سفارشی BOTTOM_START_BELOW و BOTTOM_END_BELOW ، این کنترل خارج از مرزهای قابل مشاهده نقشه قرار می‌گیرد، به این معنی که هر گونه padding اضافه شده به نقشه، موقعیت این کنترل را تغییر نمی‌دهد.

در portrait mode ، فوتر سفارشی تمام عرض است. کنترل‌های سفارشی در هر دو موقعیت CustomControlPosition.BOTTOM_START_BELOW و CustomControlPosition.BOTTOM_END_BELOW ، و همچنین عناصر رابط کاربری Nav SDK مانند دکمه‌ی re-center و لوگوی گوگل، در بالای فوتر کنترل سفارشی قرار می‌گیرند. موقعیت پیش‌فرض علامت شورون، ارتفاع فوتر سفارشی را در نظر می‌گیرد.

در landscape mode ، پاورقی سفارشی به اندازه نصف عرض است و با سمت شروع (سمت چپ در چپ به راست) تراز می‌شود، درست مانند کارت Nav SDK ETA. کنترل‌های سفارشی در موقعیت CustomControlPosition.BOTTOM_START_BELOW و عناصر رابط کاربری Nav SDK مانند دکمه re-center و لوگوی گوگل در بالای پاورقی کنترل سفارشی قرار می‌گیرند. کنترل‌های سفارشی در موقعیت CustomControlPosition.BOTTOM_END_BELOW و هر عنصر رابط کاربری Nav SDK در امتداد سمت انتها (سمت راست در چپ به راست) با پایین نقشه تراز می‌شوند. موقعیت پیش‌فرض شورون هنگام وجود پاورقی سفارشی تغییر نمی‌کند زیرا پاورقی تا انتهای نقشه امتداد نمی‌یابد.

کنترل‌های سفارشی در موقعیت‌های CustomControlPosition.BOTTOM_START_BELOW و CustomControlPosition.BOTTOM_END_BELOW ، و همچنین عناصر رابط کاربری Nav SDK مانند دکمه‌ی مرکزی‌سازی مجدد و لوگوی گوگل، در بالای فوتر کنترل سفارشی قرار گرفته‌اند.

لوازم جانبی رابط کاربری نقشه

کیت توسعه نرم‌افزار ناوبری برای اندروید (Navigation SDK) لوازم جانبی رابط کاربری را ارائه می‌دهد که در طول ناوبری، مشابه آنچه در برنامه Google Maps برای اندروید یافت می‌شود، ظاهر می‌شوند. می‌توانید میزان دید یا ظاهر بصری این کنترل‌ها را همانطور که در این بخش توضیح داده شده است، تنظیم کنید. تغییراتی که در اینجا ایجاد می‌کنید، در جلسه ناوبری بعدی اعمال می‌شوند.

برای راهنمایی در مورد تغییرات قابل قبول در رابط کاربری ناوبری، به صفحه سیاست‌ها مراجعه کنید.

کد را مشاهده کنید

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

برجسته‌سازی مقصد و ورودی‌ها

وقتی مقصدی با placeID ایجاد می‌شود، ساختمان مقصد هایلایت شده و در صورت امکان، یک آیکون ورودی نمایش داده می‌شود. این نشانه‌های بصری به کاربران کمک می‌کند تا مقصد خود را تشخیص داده و به آن دسترسی پیدا کنند.

برای ایجاد یک مقصد با placeID ، از متد Waypoint.Builder.setPlaceIdString() استفاده کنید.

تغییر هدر ناوبری

از SupportNavigationFragment.setStylingOptions() یا NavigationView.setStylingOptions() برای تغییر تم هدر ناوبری و نشانگر نوبت بعدی که در صورت وجود، در زیر هدر ظاهر می‌شود، استفاده کنید.

می‌توانید ویژگی‌های زیر را تنظیم کنید:

مثال زیر نحوه تنظیم گزینه‌های استایل‌بندی را نشان می‌دهد:

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

لایه ترافیک را خاموش کنید

از GoogleMap.setTrafficEnabled() برای فعال یا غیرفعال کردن لایه ترافیک روی نقشه استفاده کنید. این تنظیم بر روی نشانه‌های تراکم ترافیک نشان داده شده روی نقشه به طور کلی تأثیر می‌گذارد. با این حال، بر نشانه‌های ترافیک روی مسیر ترسیم شده توسط ناوبر تأثیری ندارد.

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

فعال کردن چراغ راهنمایی و علائم ایست

شما می‌توانید نمایش چراغ‌های راهنمایی و تابلوهای ایست را در نقشه در حین ناوبری فعال فعال کنید، که زمینه بیشتری برای مسیرها و مانورهای سفر فراهم می‌کند.

به طور پیش‌فرض، چراغ‌های راهنمایی و تابلوهای ایست در Navigation SDK غیرفعال هستند. برای فعال کردن این ویژگی، DisplayOptions برای هر ویژگی به طور مستقل فراخوانی کنید.

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

اضافه کردن نشانگرهای سفارشی

کیت توسعه نرم‌افزار ناوبری اندروید (Navigation SDK) اکنون از APIهای نقشه‌های گوگل برای نشانگرها استفاده می‌کند. برای اطلاعات بیشتر به مستندات API نقشه‌ها مراجعه کنید.

متن شناور

شما می‌توانید متن شناور را در هر کجای برنامه خود اضافه کنید، مشروط بر اینکه شامل انتساب گوگل نباشد. کیت توسعه نرم‌افزار ناوبری (Navigation SDK) از اتصال متن به عرض/طول جغرافیایی روی نقشه یا به یک برچسب پشتیبانی نمی‌کند. برای اطلاعات بیشتر به پنجره‌های اطلاعات (Info windows) مراجعه کنید.

نمایش محدودیت سرعت

شما می‌توانید از طریق برنامه‌نویسی، آیکون محدودیت سرعت را نمایش یا پنهان کنید. برای نمایش یا پنهان کردن آیکون محدودیت سرعت NavigationView.setSpeedLimitIconEnabled() یا SupportNavigationFragment.setSpeedLimitIconEnabled() استفاده کنید. در صورت فعال بودن، آیکون محدودیت سرعت در گوشه پایین صفحه هنگام راهنمایی نمایش داده می‌شود. این آیکون، محدودیت سرعت جاده‌ای را که وسیله نقلیه در آن حرکت می‌کند، نمایش می‌دهد. این آیکون فقط در مکان‌هایی ظاهر می‌شود که داده‌های قابل اعتمادی در مورد محدودیت سرعت در دسترس باشد.

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

وقتی دکمه recenter نمایش داده می‌شود، آیکون محدودیت سرعت موقتاً پنهان می‌شود.

تنظیم حالت شب

شما می‌توانید رفتار حالت شب را از طریق برنامه‌نویسی کنترل کنید. برای فعال یا غیرفعال کردن حالت شب NavigationView.setForceNightMode() یا SupportNavigationFragment.setForceNightMode() استفاده کنید، یا اجازه دهید Navigation SDK برای اندروید آن را کنترل کند.

• AUTO : به SDK ناوبری اجازه می‌دهد حالت مناسب را با توجه به موقعیت مکانی دستگاه و زمان محلی تعیین کند.
• FORCE_NIGHT حالت شب را به اجبار فعال می‌کند.
• FORCE_DAY حالت روز را فعال می‌کند.

مثال زیر فعال کردن حالت شب را در یک قطعه ناوبری نشان می‌دهد:

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

نمایش لیست مسیرها

ابتدا، نمای مورد نظر را ایجاد کرده و آن را به سلسله مراتب خود اضافه کنید.

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

مطمئن شوید که رویدادهای چرخه عمر را درست مانند NavigationView به DirectionsListView ارسال می‌کنید. برای مثال:

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

مسیرهای جایگزین را پنهان کنید

وقتی رابط کاربری با اطلاعات بیش از حد شلوغ می‌شود، می‌توانید با نمایش مسیرهای جایگزین کمتر از حالت پیش‌فرض (دو مسیر)، یا با نمایش هیچ مسیر جایگزینی، شلوغی را کاهش دهید. می‌توانید این گزینه را قبل از دریافت مسیرها با فراخوانی متد RoutingOptions.alternateRoutesStrategy() با یکی از مقادیر شمارشی زیر پیکربندی کنید:

مثال کد زیر نحوه پنهان کردن مسیرهای جایگزین را به طور کلی نشان می‌دهد.

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

نوار پیشرفت سفر

نوار پیشرفت سفر، یک نوار عمودی است که هنگام شروع پیمایش، در سمت شروع/جلوی نقشه ظاهر می‌شود. وقتی فعال باشد، نمای کلی از کل سفر، به همراه مقصد و موقعیت فعلی کاربر را نمایش می‌دهد.

این قابلیت به کاربران این امکان را می‌دهد که بدون نیاز به بزرگنمایی، به سرعت هرگونه مشکل پیش رو، مانند ترافیک، را پیش‌بینی کنند. سپس می‌توانند در صورت لزوم، مسیر سفر را تغییر دهند. اگر کاربر مسیر سفر را تغییر دهد، نوار پیشرفت طوری تنظیم مجدد می‌شود که انگار سفر جدیدی از آن نقطه آغاز شده است.

نوار پیشرفت سفر، نشانگرهای وضعیت زیر را نمایش می‌دهد:

• مسیر طی شده - بخش سپری شده از سفر.

• موقعیت فعلی — مکان فعلی کاربر در طول سفر.

• وضعیت ترافیک — وضعیت ترافیک آینده.

• مقصد نهایی - مقصد نهایی سفر.

نوار پیشرفت سفر را با فراخوانی متد setTripProgressBarEnabled() در NavigationView یا SupportNavigationFragment فعال کنید. برای مثال:

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

موقعیت‌یابی نوار پیشرفت سفر

• سمت چپ نوار تقریباً با سمت چپ سرعت‌سنج، لوگوی گوگل و دکمه‌ی «بازگرداندن به مرکز» (در صورت قابل مشاهده بودن) هم‌تراز است. عرض آن ۱۲ dp است.
• نوار پیشرفت سفر، ارتفاع ثابتی را حفظ می‌کند. برای سازگاری با محدودیت‌های فضای عمودی در دستگاه‌های کوچک‌تر، میزان دید و ارتفاع نوار پیشرفت سفر بر اساس نقاط شکست مشخص شده در ارتفاع صفحه نمایش تنظیم می‌شود. این نقاط شکست مستقل از جهت دستگاه و میزان فضایی هستند که نقشه واقعاً روی صفحه نمایش اشغال می‌کند:

ارتفاع صفحه نمایش	قابلیت مشاهده نوار پیشرفت سفر	ارتفاع نوار پیشرفت سفر	نوار پیشرفت سفر، موقعیت محور y
کوچک: 0 نقطه در اینچ - 551 نقطه در اینچ	قابل مشاهده نیست	ناموجود	ناموجود
متوسط: ۵۵۲ دی‌پی - ۷۳۹ دی‌پی	قابل مشاهده	۱۳۰ نقطه در اینچ	کنترل‌های بالای سمت استارت (سرعت‌سنج / لوگوی گوگل / دکمه‌ی تنظیم مجدد در مرکز)
بزرگ: ۷۴۰ نقطه در اینچ و بالاتر	قابل مشاهده	۲۹۰ نقطه در اینچ	کنترل‌های بالای سمت استارت (سرعت‌سنج / لوگوی گوگل / دکمه‌ی تنظیم مجدد در مرکز)

• اگر نوار پیشرفت سفر با کارت نوبت یا سایر عناصر رابط کاربری ناوبری همپوشانی داشته باشد، زیر آن عناصر دیگر ظاهر می‌شود.

قطب‌نما

کیت توسعه نرم‌افزار ناوبری (Navigation SDK) یک قطب‌نمای گرافیکی ارائه می‌دهد که در شرایط خاص و فقط در صورت فعال بودن، در گوشه سمت راست بالای نقشه ظاهر می‌شود. وقتی کاربر روی قطب‌نما کلیک می‌کند، دوربین به موقعیتی با جهت صفر (جهت پیش‌فرض) برمی‌گردد و قطب‌نما کمی بعد محو می‌شود.

اگر ناوبری فعال باشد و حالت دوربین روی «دنبال کردن» تنظیم شده باشد، قطب‌نما همچنان قابل مشاهده است و ضربه زدن روی قطب‌نما، بین نمای دوربین کج‌شده و نمای کلی تغییر حالت می‌دهد.

برای جلوگیری از حواس‌پرتی راننده، اگر سرصفحه (در حالت عمودی) باز شود و با موقعیت پیش‌فرض قطب‌نما تداخل داشته باشد، قطب‌نما در همان موقعیت باقی می‌ماند. اگر یک کنترل سفارشی سرصفحه ثانویه یا نمای جانبی سرصفحه اضافه کنید، قطب‌نما برای جلوگیری از تداخل رابط کاربری پنهان می‌شود.

قطب‌نما از حالت‌های روز و شب و همچنین حالت تاریک پشتیبانی می‌کند.

قطب‌نما به طور پیش‌فرض فعال است. می‌توانید با استفاده از متد comapassEnabled در کلاس GoogleMapOptions فعال بودن یا نبودن قطب‌نما را تنظیم کنید.

ساختمان‌های سه‌بعدی را خاموش کنید

برای دستگاه‌هایی که عملکردشان محدود است، می‌توانید نمایش ساختمان‌های سه‌بعدی را با فراخوانی GoogleMap.setBuildingsEnabled(false) غیرفعال کنید.

API قابلیت مشاهده سریع (آزمایشی)

API Prompt Visibility به شما این امکان را می‌دهد که با اضافه کردن یک شنونده (listener) برای دریافت یک فراخوانی (callback) قبل از نمایش یک عنصر رابط کاربری Navigation SDK و به محض حذف آن عنصر، از تداخل بین عناصر رابط کاربری تولید شده توسط Navigation SDK و عناصر رابط کاربری سفارشی خود جلوگیری کنید. برای اطلاعات بیشتر، از جمله نمونه‌های کد، به بخش API Prompt Visibility در صفحه Configure real-time-disruptions مراجعه کنید.