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

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

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

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

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

لوضع عناصر واجهة مستخدم مخصّصة في طريقة عرض التنقّل، استخدِم عناصر التحكّم في واجهة مستخدم الخريطة من أجل تحديد الموضع المناسب. عندما يتغيّر التنسيق المضمّن، يعيد Navigation SDK for Android تلقائيًا وضع عناصر التحكّم المخصّصة. يمكنك ضبط طريقة عرض واحدة لعنصر تحكّم مخصّص في كل موضع في كل مرة. إذا كان تصميمك يتطلّب عناصر متعدّدة في واجهة المستخدم، يمكنك وضعها في ViewGroup وتمريرها إلى طريقة setCustomControl.

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

• SECONDARY_HEADER (يظهر في الوضع العمودي فقط)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

إضافة عنصر تحكّم مخصّص

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

3. استخدِم NavigationView.setCustomControl أو SupportNavigationFragment.setCustomControl مع موضع عنصر التحكّم المخصّص الذي تم اختياره من CustomControlPosition تعداد.

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

    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 مرئية على طول الجانب من جهة النهاية (الجانب الأيسر في اللغات التي تُكتب من اليمين إلى اليسار) إلى الأعلى لتعويض ارتفاع طريقة عرض عنصر التحكّم المخصّص. يتم وضع عنصر التحكّم هذا داخل حدود الخريطة المرئية، لذا فإنّ أي مسافة داخلية تتم إضافتها إلى الحافتَين السفلية أو من جهة النهاية للخريطة ستغيّر أيضًا موضع عنصر التحكّم هذا.

التذييل

لاستخدام موضع عنصر التحكّم المخصّص هذا، مرِّر الموضع CustomControlPosition.FOOTER إلى setCustomControl.

تم تصميم موضع عنصر التحكّم المخصّص هذا لطريقة عرض تذييل مخصّصة. إذا كانت بطاقة الوقت المقدَّر للوصول في Nav SDK مرئية، يقع عنصر التحكّم هذا أعلاها. وإذا لم يكن الأمر كذلك، تتم محاذاة عنصر التحكّم مع أسفل الخريطة. على عكس عناصر التحكّم المخصّصة BOTTOM_START_BELOW وBOTTOM_END_BELOW، يتم وضع عنصر التحكّم هذا خارج حدود الخريطة المرئية، ما يعني أنّ أي مسافة داخلية تتم إضافتها إلى الخريطة لن تغيّر موضع عنصر التحكّم هذا.

في portrait mode، يكون التذييل المخصّص بعرض كامل. يتم وضع عناصر التحكّم المخصّصة في كل من الموضعين CustomControlPosition.BOTTOM_START_BELOW وCustomControlPosition.BOTTOM_END_BELOW، بالإضافة إلى عناصر واجهة مستخدم Nav SDK، مثل زر إعادة التوسيط وشعار Google، أعلى تذييل عنصر التحكّم المخصّص. يأخذ الموضع التلقائي لعلامة الشيفرون ارتفاع التذييل المخصّص في الاعتبار.

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

يتم وضع عناصر التحكّم المخصّصة في الموضعين CustomControlPosition.BOTTOM_START_BELOW وCustomControlPosition.BOTTOM_END_BELOW، بالإضافة إلى عناصر واجهة مستخدم Nav SDK، مثل زر إعادة التوسيط وشعار Google، أعلى تذييل عنصر التحكّم المخصّص.

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

يوفّر Navigation SDK for Android ملحقات واجهة مستخدم تظهر أثناء التنقّل بشكل مشابه لتلك المتوفّرة في تطبيق "خرائط Google" لأجهزة Android. يمكنك تعديل مستوى ظهور عناصر التحكّم هذه أو مظهرها المرئي كما هو موضّح في هذا القسم. تنعكس التغييرات التي تُجريها هنا أثناء جلسة التنقّل التالية.

يُرجى الرجوع إلى صفحة السياسات للاطّلاع على إرشادات حول التعديلات المقبولة على واجهة مستخدم التنقّل.

عرض الرمز

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.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.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;
              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 for Android الآن Google Maps APIs للعلامات. انتقِل إلى مستندات Maps API لمزيد من المعلومات.

النص العائم

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

عرض حد السرعة

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

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

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

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

يمكنك التحكّم آليًا في سلوك الوضع الليلي. استخدِم NavigationView.setForceNightMode() أو SupportNavigationFragment.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() مع إحدى قيم التعداد التالية:

يوضّح مثال الرمز التالي كيفية إخفاء المسارات البديلة تمامًا.

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

تحديد موضع شريط تقدّم الرحلة

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

ارتفاع الشاشة	مستوى ظهور شريط تقدّم الرحلة	ارتفاع شريط تقدّم الرحلة	موضع شريط تقدّم الرحلة على المحور الصادي
صغير: من 0 وحدة بكسل مستقلة الكثافة إلى 551 وحدة بكسل مستقلة الكثافة	لا يظهر	لا ينطبق	لا ينطبق
متوسط: من 552 وحدة بكسل مستقلة الكثافة إلى 739 وحدة بكسل مستقلة الكثافة	يظهر	130 وحدة بكسل مستقلة الكثافة	أعلى عناصر التحكّم من جهة البداية (عدّاد السرعة / شعار Google / زر إعادة التوسيط)
كبير: 740 وحدة بكسل مستقلة الكثافة وأكثر	يظهر	290 وحدة بكسل مستقلة الكثافة	أعلى عناصر التحكّم من جهة البداية (عدّاد السرعة / شعار Google / زر إعادة التوسيط)

• إذا تداخل شريط تقدّم الرحلة مع بطاقة المنعطف أو عناصر واجهة مستخدم التنقّل الأخرى، سيظهر أسفل هذه العناصر الأخرى.

البوصلة

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

إذا كانت ميزة التنقّل مفعّلة وتم ضبط وضع الكاميرا على "المتابعة"، تظل البوصلة مرئية ويؤدي النقر عليها إلى التبديل بين منظورَي الكاميرا المائل والعرض العام.

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

تتيح البوصلة الوضعَين النهاري والليلي، بالإضافة إلى الوضع الداكن.

البوصلة مفعّلة تلقائيًا. يمكنك ضبط ما إذا كانت البوصلة مفعّلة باستخدام compassEnabled طريقة في فئة GoogleMapOptions.

إيقاف المباني الثلاثية الأبعاد

بالنسبة إلى الأجهزة التي تكون فيها الأداء محدودًا، يمكنك إيقاف عرض المباني الثلاثية الأبعاد من خلال استدعاء GoogleMap.setBuildingsEnabled(false).

Prompt Visibility API (تجريبي)

تتيح لك Prompt Visibility API تجنُّب التعارضات بين عناصر واجهة المستخدم التي تم إنشاؤها بواسطة Navigation SDK وعناصر واجهة المستخدم المخصّصة من خلال إضافة متتبِّع لتلقّي عملية استدعاء قبل أن يظهر عنصر في واجهة المستخدم Navigation SDK وبمجرد إزالة العنصر. لمزيد من المعلومات، بما في ذلك نماذج الرموز، يُرجى الاطّلاع على قسم Prompt Visibility API في صفحة ضبط حالات الانقطاع في الوقت الفعلي.