Navigation SDK זמין כרגע רק ללקוחות נבחרים. למידע נוסף, אפשר לפנות למחלקת המכירות.

עיצוב חדש של מפות יהיה זמין בקרוב בפלטפורמה של מפות Google. העדכון הזה בסגנון המפה כולל לוח צבעים חדש שמוגדר כברירת מחדל ושיפורים בחוויית השימוש במפות ובנוחות השימוש. כל סגנונות המפה יעודכנו באופן אוטומטי במרץ 2025. אפשר לקרוא מידע נוסף על זמינות ועל האפשרות להצטרף בשלב מוקדם יותר במאמר בנושא סגנון מפה חדש לפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

שינוי ממשק המשתמש של הניווט

באמצעות ה-SDK לניווט ל-Android, אפשר לשנות את חוויית המשתמש עם על המפה שלך על ידי קביעת אילו מבין הפקדים והרכיבים המובנים של ממשק המשתמש יופיעו את המפה. אפשר גם לשנות את המראה החזותי של ממשק המשתמש של הניווט. הפניה אל דף המדיניות של הנחיות לשינויים מקובלים בממשק המשתמש של הניווט.

במסמך הזה מתואר איך לשנות את ממשק המשתמש של המפה בשתי דרכים:

פקדים בממשק המשתמש של המפה
אביזרים לממשק המשתמש במפה

פקדי ממשק המשתמש של המפה

הפקדים של ממשק המשתמש של המפה נמצאים מעל תצוגת הניווט. ה-SDK לניווט ל-Android ממקם מחדש את הפקדים המותאמים אישית באופן אוטומטי כשהפריסה המובנית משתנה. לכל מיקום של הפריסה, ניתן להגדיר אמצעי בקרה מותאם אישית אחד. הפקד המותאם אישית יכול להיות רכיב אחד בממשק המשתמש, או, אם העיצוב שלכם, דורש יותר, אפשר להשתמש ב-ViewGroup עם כמה אלמנטים של ממשק המשתמש.

setCustomControl אמצעי תשלום מספקת מיקומים כפי שמוגדר בCustomControlPosition enum:

SECONDARY_HEADER (מופיע בפריסה לאורך בלבד)
BOTTOM_START_BELOW
BOTTOM_END_BELOW

למשל, בתמונות הבאות אפשר לראות דוגמאות למיקומים שונים של פקד בממשק המשתמש שמיידעות את הנהג שמשתתף בנסיעה ששותפה, לגבי המיקום של הנוסע בזמן האיסוף.

בקרה מותאמת אישית
משרות

הוספת כותרת משנית מותאמת אישית

כברירת מחדל, פריסות מסך במצב ניווט מספקות מיקום שנמצאת מתחת לכותרת הראשית. הכותרת המשנית מופיעה כאשר הכרחי, למשל, בעזרת הנחיות לבחירת נתיב. האפליקציה שלך יכולה להשתמש בכותרת המשנית הזו מיקום הפריסה לתוכן מותאם אישית. בזמן השימוש בתכונה הזו, לבקרה על כל תוכן ברירת מחדל של כותרת משנית. אם בתצוגת הניווט יש רקע, אותו רקע נשאר במקומו ומכוסה על ידי הכותרת המשנית. כשהאפליקציה מסירה את אמצעי הבקרה בהתאמה אישית, כל כותרת משנית שמוגדרת כברירת מחדל מסירה יופיעו במקומו.

המיקום של הכותרת המשנית בהתאמה אישית מיישר את הקצה העליון שלו עם הקצה התחתון של הכותרת הראשית. המיקום הזה נתמך רק בportrait mode. לחשבון landscape mode, הכותרת המשנית לא זמינה והפריסה לא זמינה שינוי.

יצירה של Android View עם הרכיב המותאם אישית של ממשק המשתמש או ViewGroup.
מתנפח ה-XML או יוצרים תצוגה מותאמת אישית כדי לקבל מופע של כדי להוסיף ככותרת משנית.
שימוש ב-NavigationView.setCustomControl או SupportNavigationFragment.setCustomControl עם CustomControlPosition בתור {/8}ARY_ATTRIBUTE.

הערה: האפליקציה צריכה לקרוא לשיטה הזו בשרשור בממשק המשתמש.

הדוגמה הבאה יוצרת מקטע ומוסיפה פקד מותאם אישית בקטע את מיקום הכותרת המשנית.

הערה: הקוד בדוגמה כולל מעברי שורה לתצוגה בקטע התיעוד. חשוב להסיר אותן לפי הצורך.
```
 mNavFragment.setCustomControl(getLayoutInflater().
   inflate(R.layout.your_custom_control, null),
   CustomControlPosition.SECONDARY_HEADER);
 ```
```

הסרת כותרת משנית

כדי להסיר את הכותרת המשנית ולחזור לתוכן ברירת המחדל, משתמשים בפקודה אמצעי תשלום אחד (setCustomControl).

כדי להסיר את התצוגה, צריך להגדיר את התצוגה כ-null.

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

מוסיפים פקד מותאם אישית לתחתית של תצוגת הניווט

האפליקציה שלך יכולה לציין פקד מותאם אישית שמותאם לקצה התחתון של תצוגת ניווט. כשהאפליקציה שלך מוסיפה את הפקד המותאם אישית, הלחצן למרכז מחדש הלוגו של Google עולה כדי למקם אותו.

יצירה של Android View ברכיב בממשק המשתמש או בקבוצת התצוגה המפורטת שרוצים להוסיף.
יוצרים את תצוגת הניווט או את המקטע.
מפעילים את השיטה 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 משתמש עכשיו בממשקי API של מפות Google לסמנים. נכנסים אל מסמכי תיעוד של Maps API אפשר לקבל מידע נוסף.

טקסט צף

ניתן להוסיף טקסט צף בכל מקום באפליקציה, כל עוד הוא לא מכסה את ייחוס Google. ערכת ה-SDK לניווט לא תומכת בעיגון הטקסט לקו רוחב/אורך במפה או לתווית. מעבר אל מידע חלונות להצגת מידע נוסף מידע.

הצגת המהירות המותרת

ניתן להציג או להסתיר את הסמל של מגבלת המהירות באופן פרוגרמטי. כדאי להשתמש NavigationView.setSpeedLimitIconEnabled() או SupportNavigationFragment.setSpeedLimitIconEnabled() כדי להציג או להסתיר את סמל המהירות המותרת. כשההגדרה מופעלת, סמל המהירות המותרת מוצגת בפינה התחתונה במהלך ההנחיה. הסמל מציג את המהירות המותרת של הכביש שבו נוסע הרכב. הסמל מופיע רק במיקומים במקומות שבהם יש נתונים מהימנים על מגבלת המהירות.

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

סמל המהירות המותרת מוסתר באופן זמני כשלחצן מרכוז מחדש מוצגת.

הגדרת מצב לילה

אפשר לשלוט באופן פרוגרמטי בהתנהגות של מצב לילה. כדאי להשתמש NavigationView.setForceNightMode() או SupportNavigationFragment.setForceNightMode() כדי להפעיל או להשבית את מצב לילה, או כדי להפעיל את ה-Navigation SDK ל-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 או SupportNavigationFragment. לדוגמה:

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