اصلاح کردن میانای کاربر پیمایش

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

این سند نحوه اصلاح میانای کاربر نقشه را به دو روش شرح می‌دهد:

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

توجه: در اکثر موارد، توصیه می‌کنیم به‌جای تعامل مستقیم با NavigationView، از NavigationFragment که پوششی برای NavigationView است استفاده کنید. برای اطلاعات بیشتر، روال‌های مطلوب تعامل با نقشه ناوبری را ببینید.

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

توجه: کنترل‌های چیدمان مبتنی بر جایگاه که در این بخش شرح داده شده است، مانند setCustomControl، منسوخ خواهد شد. توصیه می‌شود به‌جای آن از ویژگی آزمایشی سفارشی‌سازی چیدمان استفاده کنید.

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

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

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

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

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

افزودن کنترل سفارشی

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

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

   توجه: برنامه شما باید این روش را در رشته میانای کاربر فراخوانی کند.

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

   توجه: کد موجود در مثال دارای شکستگی خط است تا در مستندات قابل‌مشاهده باشد. حتماً آن‌ها را به‌طور مناسب بردارید.

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

برداشتن کنترل سفارشی

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

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

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

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

سرصفحه فرعی

موقعیت کنترل سفارشی سرایند ثانویه برای جهت عمودی

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

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

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

شروع پایین

موقعیت کنترل سفارشی شروع پایین برای جهت عمودی

موقعیت کنترل سفارشی شروع پایین برای جهت افقی

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

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

پایین

موقعیت کنترل سفارشی انتهای پایین برای جهت عمودی

موقعیت کنترل سفارشی انتهای پایین برای جهت افقی

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

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

پانویس

ویژگی پیش‌نمایش

موقعیت کنترل سفارشی پانویس برای جهت عمودی

موقعیت کنترل سفارشی پانویس برای جهت افقی

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

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

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

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

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

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

کیت توسعه نرم‌افزار پیمایش برای Android لوازم جانبی واسط کاربری را ارائه می‌دهد که درطول پیمایش ظاهر می‌شوند و شبیه به مواردی هستند که در برنامه Google Maps برای Android یافت می‌شوند. می‌توانید رؤیت‌پذیری یا ظاهر بصری این کنترل‌ها را همان‌طور که در این بخش شرح داده شده است تنظیم کنید. تغییراتی که در اینجا ایجاد می‌کنید در جلسه ناوبری بعدی اعمال می‌شود.

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

مشاهده کد

نمایش/پنهان کردن کد Java برای فعالیت پیمایش.

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.AudioGuidanceSettings;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.NavigationFragment;
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.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 NavigationFragment 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 =
                (NavigationFragment)
                    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).
                AudioGuidanceSettings audioSettings =
                    AudioGuidanceSettings.builder()
                        .setGuidanceMode(
                            AudioGuidanceSettings.GuidanceMode.VOICE_ALERTS_AND_GUIDANCE)
                        .build();
                mNavigator.setAudioGuidanceSettings(audioSettings);

                // 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;
              case ROUTING_TIMEOUT:
                displayMessage("Error starting navigation: Routing timed out.");
                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() استفاده کنید.

توجه: Navigation SDK از ناوبری داخلی پشتیبانی نمی‌کند. برای نقشه‌های داخلی بدون ناوبری، از کلاس‌های indoorBuilding و indoorLevel از کیت توسعه نرم‌افزار Maps برای Android استفاده کنید.

اصلاح کردن سرایند پیمایش

از NavigationFragment.setStylingOptions() یا NavigationView.setStylingOptions() برای تغییر زمینه سرصفحه پیمایش و نشانگر پیچ بعدی که درصورت وجود در زیر سرصفحه نشان داده می‌شود استفاده کنید.

توجه: ارتفاع پیش‌فرض سرصفحه پویا است و براساس راهنمای مانور نمایش‌داده‌شده اندازه‌گذاری می‌شود.

می‌توانید مشخصه‌های زیر را تنظیم کنید:

نوع مشخصه	مشخصه‌ها
رنگ پس‌زمینه	حالت روز اصلی - رنگ روزانه سرصفحه ناوبری حالت روز ثانویه - رنگ روز نشانگر پیچ بعدی حالت شب اصلی - رنگ شبانه سرصفحه پیمایش حالت شب ثانویه - رنگ شبانه نشانگر پیچ بعدی
عناصر نوشتاری برای دستورالعمل‌ها	رنگ نوشتار قلم اندازه نوشتار ردیف اول اندازه نوشتار ردیف دوم
عناصر نوشتاری برای مراحل بعدی	قلم رنگ نوشتار مقدار فاصله اندازه نوشتار مقدار فاصله رنگ نوشتار واحدهای فاصله اندازه نوشتار واحدهای فاصله
نمادهای مانور	رنگ نماد مانور بزرگ رنگ نماد مانور کوچک
راهنمای خطوط	رنگ لاین یا لاین‌های توصیه‌شده

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

private NavigationFragment mNavFragment;
mNavFragment = (NavigationFragment) getSupportFragmentManager()
  .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));

چراغ‌های راهنمایی و علائم ایست

درطول ناوبری فعال، نقشه چراغ‌های راهنمایی و علائم ایست را نشان می‌دهد تا بافت بیشتری درباره مسیر و مانورهای پیش‌رو به کاربران ارائه دهد. از نسخه ۸.۰.۰ به بعد، نمی‌توانید این ویژگی را خاموش کنید.

توجه: چراغ‌های راهنمایی ممکن است در حالت‌های غیرناوبری نیز روی نقشه ظاهر شوند.

افزودن نشانگرهای سفارشی

کیت توسعه نرم‌افزار پیمایش برای Android اکنون از میاناهای برنامه‌سازی کاربردی Google Maps برای نشانگرها استفاده می‌کند. برای اطلاعات بیشتر، به اسناد Maps API بروید.

نوشتار شناور

می‌توانید نوشتار شناور را در هر جایی از برنامه‌تان اضافه کنید، به‌شرطی که ارجاع Google را نپوشاند. کیت توسعه نرم‌افزار ناوبری از لنگر انداختن نوشتار به عرض/طول جغرافیایی روی نقشه یا به برچسب پشتیبانی نمی‌کند. برای اطلاعات بیشتر، به پنجره‌های اطلاعات بروید.

نمایش حد سرعت

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

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

وقتی دکمه «مرکز کردن مجدد» نمایش داده می‌شود، نماد سقف سرعت مجاز موقتاً پنهان می‌شود.

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

تنظیم حالت شب

می‌توانید رفتار حالت شب را به‌صورت برنامه‌نویسی‌شده کنترل کنید. از NavigationView.setForceNightMode() یا NavigationFragment.setForceNightMode() برای روشن یا خاموش کردن حالت شب استفاده کنید، یا اجازه دهید Navigation SDK for Android آن را کنترل کند.

• AUTO به Navigation 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));
}

حتماً رویدادهای چرخه حیات را به DirectionsListView بازارسال کنید، درست همان‌طور که با NavigationView انجام می‌شود. برای مثال:

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

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

هشدار: این ویژگی با ویژگی کوتاه‌ترین/سریع‌ترین مسیر ناسازگار است. استفاده هم‌زمان از هر دو ویژگی می‌تواند باعث رفتار غیرمنتظره شود.

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

ارزش فهرست	شرح
AlternateRoutesStrategy.SHOW_ALL	پیش‌فرض. حداکثر دو مسیر جایگزین را نمایش می‌دهد.
AlternateRoutesStrategy.SHOW_ONE	یک مسیر جایگزین را نمایش می‌دهد (اگر وجود داشته باشد).
AlternateRoutesStrategy.SHOW_NONE	مسیرهای جایگزین را پنهان می‌کند.

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

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

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

ویژگی آزمایشی

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

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

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

• مسیر سپری‌شده—بخش سپری‌شده سفر.

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

• وضعیت ترافیک—وضعیت ترافیک پیش‌رو.

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

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

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

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

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

ارتفاع صفحه‌نمایش	رؤیت‌پذیری نوار پیشرفت سفر	ارتفاع نوار پیشرفت سفر	موقعیت محور y نوار پیشرفت سفر
کوچک: ۰ تا ۵۵۱ پیکسل مستقل از تراکم	غیرقابل‌رؤیت	موجود نیست	موجود نیست
متوسط: ۵۵۲ تا ۷۳۹ دی‌پی	قابل مشاهده	‫۱۳۰ پیکسل مستقل از تراکم	بالای کنترل‌های کناری شروع (سرعت‌سنج / نشان‌واره Google / دکمه «مرکز کردن مجدد»)
بزرگ: ۷۴۰ dp و بالاتر	قابل مشاهده	‫۲۹۰ پیکسل مستقل از تراکم	بالای کنترل‌های کناری شروع (سرعت‌سنج / نشان‌واره Google / دکمه «مرکز کردن مجدد»)

توجه: مقادیر ارتفاع صفحه‌نمایش نشان‌داده‌شده در جدول بالا برای نسخه‌های Navigation SDK‏ ۶.۲.۱ و بالاتر اعمال می‌شود. برای نسخه ۶.۲.۰، صفحه‌نمایش‌های کوچک به‌صورت ۰ تا ۵۱۹ پیکسل مستقل از تراکم، صفحه‌نمایش‌های متوسط به‌صورت ۵۲۰ تا ۵۹۹ پیکسل مستقل از تراکم، و صفحه‌نمایش‌های بزرگ به‌صورت ۶۰۰ پیکسل مستقل از تراکم و بالاتر تعریف می‌شوند. رؤیت‌پذیری، ارتفاع، و موقعیت محور y نوار پیشرفت سفر یکسان است.
• اگر نوار پیشرفت سفر با کارت پیچ یا دیگر عناصر میانای کاربر «ناوبری» هم‌پوشانی داشته باشد، زیر آن عناصر دیگر نشان داده می‌شود.

قطب‌نما

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

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

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

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

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

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

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

Prompt Visibility API (آزمایشی)

ویژگی آزمایشی

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