تعديل واجهة مستخدم التنقل

باستخدام حزمة SDK للتنقل لنظام Android، يمكنك تعديل تجربة المستخدم مع الخريطة من خلال تحديد عناصر التحكم والعناصر المدمجة في واجهة المستخدم التي تظهر على الخريطة. يمكنك أيضًا ضبط المظهر المرئي لواجهة مستخدم التنقل. راجِع صفحة "السياسات" للاطّلاع على إرشادات حول التعديلات المقبولة على واجهة مستخدم التنقّل.

يصف هذا المستند كيفية تعديل واجهة مستخدم الخريطة بطريقتين:

• عناصر تحكُّم واجهة المستخدم على الخريطة
• ملحقات واجهة المستخدم على الخرائط

تنبيه: لا تتوافق "حزمة تطوير البرامج (SDK) للتنقّل في Android" مع تصميم الخرائط المستند إلى السحابة الإلكترونية باستخدام أرقام تعريف الخرائط.

عناصر التحكّم في واجهة المستخدم للخريطة

تقع عناصر التحكم في واجهة المستخدم للخريطة أعلى عرض التنقل. تعمل حزمة تطوير البرامج (SDK) للتنقل لنظام التشغيل Android على تغيير موضع عناصر التحكّم المخصّصة تلقائيًا عند تغيُّر التنسيق المضمَّن. ويمكنك ضبط عنصر تحكّم مخصّص واحد لكل موضع من مواضع التخطيط. يمكن أن يكون عنصر التحكّم المخصّص عنصرًا واحدًا في واجهة المستخدم، أو إذا كان تصميمك يتطلّب المزيد، يمكنك استخدام ViewGroup مع عدة عناصر واجهة مستخدم.

توفّر طريقة setCustomControl مواضع على النحو المحدّد في تعداد CustomControlPosition:

• SECONDARY_HEADER (يظهر في وضع "بورتريه" فقط)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW

على سبيل المثال، تعرض الصور أدناه أمثلة على مواضع مختلفة لعنصر تحكم في واجهة المستخدم تخبر سائق مشاركة الرحلات بموقع الراكب أثناء عملية الركوب.

إضافة عنوان ثانوي مخصّص

بشكل افتراضي، توفر تخطيطات الشاشة في وضع التنقل موضعًا لعنوان ثانوي موجود أسفل العنوان الأساسي. ويظهر هذا العنوان الثانوي عند الضرورة، كما هو الحال مع إرشادات الممرات. يمكن لتطبيقك استخدام موضع العنوان الثانوي هذا للتخطيط للمحتوى المخصص. عند استخدام هذه الميزة، يغطي عنصر التحكم أي محتوى رأس ثانوي افتراضي. إذا كان عرض التنقل الخاص بك يحتوي على خلفية، تظل تلك الخلفية في مكانها، ويغطيها العنوان الثانوي. عندما يزيل تطبيقك عنصر التحكّم المخصّص، يمكن أن يظهر أيّ عنوان ثانوي تلقائي بدلاً منه.

يعمل موضع العنوان الثانوي المخصص على محاذاة الحافة العلوية مع الحافة السفلية للرأس الأساسي. لا يتوفّر هذا الموضع إلا في portrait mode. في landscape mode، يكون الرأس الثانوي غير متاح، ولا يتغير التنسيق.

1. أنشئ طريقة عرض Android باستخدام عنصر واجهة المستخدم المخصّصة أو ViewGroup.
2. يمكنك تضخيم XML أو إنشاء مثيل للعرض المخصّص للحصول على مثيل للعرض لإضافته باعتباره عنوانًا ثانويًا.

3. استخدِم NavigationView.setCustomControl أو SupportNavigationFragment.setCustomControl مع CustomControlPosition كالثاني فيARY_Header.

   ملاحظة: من المفترض أن يستدعي تطبيقك هذه الطريقة في سلسلة واجهة المستخدم.

   ينشئ المثال أدناه جزءًا ويضيف عنصر تحكُّم مخصّصًا في موضع العنوان الثانوي.

   ملاحظة: يحتوي الرمز في المثال على فواصل أسطر يمكن رؤيتها في المستندات. لذا يُرجى الحرص على إزالتها حسب الحاجة.

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

إزالة عنوان ثانوي

لإزالة العنوان الثانوي والرجوع إلى المحتوى التلقائي، استخدِم الطريقة setCustomControl.

اضبط العرض على null لإزالة طريقة العرض.

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

إضافة عنصر تحكّم مخصّص أسفل طريقة عرض التنقّل

يمكن لتطبيقك تحديد عنصر تحكّم مخصّص تتماشى مع الحافة السفلى لعرض التنقّل. عندما يضيف تطبيقك عنصر تحكم مخصصًا، يتحرك زر إعادة التوسيط وشعار Google إلى أعلى لاستيعابه.

1. أنشئ طريقة عرض Android باستخدام عنصر واجهة المستخدم أو مجموعة العرض التي تريد إضافتها.
2. أنشئ عرض التنقل أو الجزء.
3. وعليك استدعاء الطريقة setCustomControl في طريقة عرض التنقّل أو الجزء فيه وتحديد عنصر التحكّم والموضع المطلوب استخدامه.

ملاحظة: يجب أن يستخدم تطبيقك هذه الطريقة في سلسلة واجهة المستخدم.

يعرض المثال التالي سمة View مخصّصة تمت إضافتها إلى 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);

إزالة عنصر تحكّم مخصّص

لإزالة عنصر التحكّم المخصّص، استخدِم الطريقة setCustomControl وحدِّد موضع عنصر التحكّم الذي تريد إزالته.

اضبط العرض على null لهذا الموضع.

mNavFragment.setCustomControl(null, CustomControlPosition.BOTTOM_END_BELOW);

ملحقات واجهة المستخدم للخريطة

توفر حزمة SDK للتنقل لنظام التشغيل Android ملحقات واجهة المستخدم التي تظهر أثناء التنقل على نحو مشابه لتلك الموجودة في تطبيق خرائط Google لنظام التشغيل 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.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import com.google.android.libraries.navigation.Camera;
import com.google.android.libraries.navigation.LatLng;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.Marker;
import com.google.android.libraries.navigation.MarkerOptions;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.NavigationMap;
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 NavigationMap 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) getFragmentManager()
                                .findFragmentById(R.id.navigation_fragment);

                        // 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));
        // Get the map.
        mMap = mNavFragment.getMap();
        // Turn off the traffic layer on the map.
        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(destinationMarkerIcon)
                    .title("Destination marker"));

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


        // Set the camera to follow the device location with 'TILTED' driving view.
        mNavFragment.getCamera().followMyLocation(Camera.Perspective.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.fromPlaceId(placeId, null);
        } 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);
    }
}

تعديل عنوان التنقل

استخدِم 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));

تفعيل إشارات المرور ولافتات الوقوف

يمكنك تفعيل إشارات المرور وإيقاف إشارات المرور في واجهة مستخدم الخريطة. وباستخدام هذه الميزة، يمكن للمستخدم تفعيل عرض إشارات المرور أو رموز لافتات التوقف على طول مساره، ما يوفّر سياقًا أفضل للرحلات الأكثر كفاءة ودقة.

يتم إيقاف إشارات المرور وإشارات التوقف بشكل افتراضي في حزمة SDK للتنقل. لتفعيل هذه الميزة، يمكنك استدعاء DisplayOptions لكل ميزة على حدة.

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

إضافة علامات مخصصة

تستخدم حزمة تطوير البرامج (SDK) للتنقل لنظام التشغيل Android الآن واجهات برمجة التطبيقات لخرائط Google في العلامات. انتقل إلى وثائق واجهة برمجة تطبيقات الخرائط للحصول على مزيد من المعلومات.

نص عائم

يمكنك إضافة نص عائم في أي مكان في تطبيقك، بشرط ألا يغطّي إحالة Google. لا تدعم حزمة SDK للتنقل تثبيت النص بخط عرض/خط طول على الخريطة أو بتسمية. انتقِل إلى نوافذ المعلومات للاطّلاع على المزيد من المعلومات.

عرض الحد الأقصى للسرعة

يمكنك إظهار رمز حد السرعة أو إخفاؤه آليًا. يمكنك استخدام NavigationView.setSpeedLimitIconEnabled() أو SupportNavigationFragment.setSpeedLimitIconEnabled() لعرض رمز حد السرعة أو إخفائه. عند تفعيل هذه الميزة، يظهر رمز حد السرعة في الزاوية السفلية أثناء التوجيه. تعرض الأيقونة حد سرعة الطريق التي تسير عليها المركبة. لا تظهر الأيقونة إلا في المواقع التي توفر فيها بيانات موثوقة عن حد السرعة.

// عرض رمز الحد الأقصى للسرعة mNavFragment.setSpeedLimitIconEnabled(true)

يكون رمز حد السرعة مخفيًا مؤقتًا عند عرض زر إعادة التوسيط.

ملاحظة: على المستخدمين اتّباع جميع اللافتات المنشورة على الطريق. تعمل البيانات المنشورة في رمز حد السرعة كمرجع فقط. لا يمكن ضمان دقة بيانات حد السرعة. يمكنك الإبلاغ عن عدم الدقة في بيانات حدود السرعة من خلال تقديم طلب في صفحة دعم Google Cloud.

ضبط "الوضع الليلي"

يمكنك التحكّم آليًا في سلوك "الوضع الليلي". يمكنك استخدام NavigationView.setForceNightMode() أو SupportNavigationFragment.setForceNightMode() لتفعيل "الوضع الليلي" أو إيقافه، أو اسمح لـ "حزمة تطوير البرامج (SDK) للتنقل" لنظام التشغيل Android بالتحكّم فيه.

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

احرص على إعادة توجيه أحداث دورة الحياة إلى 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 أو SupportNavigationFragment. مثلاً:

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