Modifier l'interface utilisateur de navigation

Le SDK Navigation pour Android vous permet de modifier l'expérience utilisateur avec votre carte en définissant quels sont les commandes et éléments d'interface utilisateur intégrés qui apparaissent sur la carte. Vous pouvez également ajuster l'apparence visuelle de l'interface utilisateur de navigation. Consultez la page Règles pour obtenir des consignes sur les modifications acceptables de l'interface utilisateur de navigation.

Ce document explique comment modifier l'interface utilisateur de votre carte de deux manières :

• Commandes d'interface utilisateur de la carte
• Accessoires d'interface utilisateur de la carte

Remarque : Dans la plupart des cas, nous vous recommandons d'utiliser SupportNavigationFragment, qui est un wrapper pour NavigationView, au lieu d'interagir directement avec NavigationView. Pour en savoir plus, consultez Bonnes pratiques d'interaction avec la carte de navigation .

Commandes d'interface utilisateur de la carte

Pour placer des éléments d'interface utilisateur personnalisés sur la vue de navigation, utilisez les commandes d'interface utilisateur de la carte pour un positionnement approprié. Lorsque la mise en page intégrée change, le SDK Navigation pour Android repositionne automatiquement vos commandes personnalisées. Vous pouvez définir une vue de commande personnalisée à la fois pour chaque position. Si votre conception nécessite plusieurs éléments d'interface utilisateur, vous pouvez les placer dans un ViewGroup et le transmettre à la méthode setCustomControl.

La setCustomControl méthode fournit des positions telles que définies dans l'CustomControlPosition énumération :

• SECONDARY_HEADER (apparaît en mode Portrait uniquement)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

Positions des commandes personnalisées pour l'orientation portrait

Positions des commandes personnalisées pour l'orientation paysage

Ajouter une commande personnalisée

1. Créez une vue Android avec l'élément d'interface utilisateur personnalisé ou ViewGroup.
2. Développez le code XML ou instanciez la vue personnalisée pour obtenir une instance de la vue.

3. Utilisez NavigationView.setCustomControl ou SupportNavigationFragment.setCustomControl avec la position de commande personnalisée choisie dans l'énumération CustomControlPosition.

   **Remarque** : Votre application doit appeler cette méthode sur le thread d'interface utilisateur.

   L'exemple ci-dessous crée un fragment et ajoute une commande personnalisée dans la position d'en-tête secondaire.

   Remarque : Le code de l'exemple comporte des sauts de ligne pour être visible dans la documentation. Veillez à les supprimer si nécessaire.

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

Supprimer une commande personnalisée

Pour supprimer une commande personnalisée, appelez la méthode setCustomControl avec un paramètre de vue null et la position de commande personnalisée choisie.

Par exemple, l'extrait de code suivant supprime tout en-tête secondaire personnalisé et rétablit le contenu par défaut :

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Positions des commandes personnalisées

En-tête secondaire

Position de la commande personnalisée de l'en-tête secondaire pour l'orientation portrait

Pour utiliser cette position de commande personnalisée, transmettez la position CustomControlPosition.SECONDARY_HEADER à setCustomControl.

Par défaut, les mises en page d'écran en mode navigation fournissent une position pour un en-tête secondaire situé sous l'en-tête principal. Cet en-tête secondaire s'affiche lorsque cela est nécessaire, par exemple avec l'assistant de voies de circulation. Votre application peut utiliser cette position d'en-tête secondaire de la mise en page pour du contenu personnalisé. Lorsque vous utilisez cette fonctionnalité, votre commande couvre tout contenu d'en-tête secondaire par défaut. Si votre vue de navigation comporte un arrière-plan, celui-ci reste en place, couvert par l'en-tête secondaire. Lorsque votre application supprime la commande personnalisée, tout en-tête secondaire par défaut peut apparaître à sa place.

La position de l'en-tête secondaire personnalisé aligne son bord supérieur avec le bord inférieur de l'en-tête principal. Cette position n'est compatible qu'avec portrait mode. En landscape mode, l'en-tête secondaire n'est pas disponible et la mise en page ne change pas.

Début en bas

Position de la commande personnalisée du début en bas pour l'orientation portrait

Position de la commande personnalisée du début en bas pour l'orientation paysage

Pour utiliser cette position de commande personnalisée, transmettez la position CustomControlPosition.BOTTOM_START_BELOW à setCustomControl.

Cette position de commande personnalisée se trouve dans l'angle inférieur gauche de la carte. En portrait mode et en landscape mode, elle se trouve au-dessus de la fiche indiquant l'heure d'arrivée prévue et/ou du pied de page personnalisé (ou en bas de la carte si aucun des deux n'est présent). Les éléments du SDK Navigation, y compris le bouton de recentrage et le logo Google, se déplacent vers le haut pour tenir compte de la hauteur de la vue de commande personnalisée. Cette commande est positionnée à l'intérieur des limites visibles de la carte. Par conséquent, toute marge intérieure ajoutée aux bords inférieur ou gauche de la carte modifie également la position de cette commande.

Fin en bas

Position de la commande personnalisée de la fin en bas pour l'orientation portrait

Position de la commande personnalisée de la fin en bas pour l'orientation paysage

Pour utiliser cette position de commande personnalisée, transmettez la position CustomControlPosition.BOTTOM_END_BELOW à setCustomControl.

Cette position de commande personnalisée se trouve dans l'angle inférieur droit de la carte. En portrait mode, elle se trouve au-dessus de la fiche indiquant l'heure d'arrivée prévue et/ou du pied de page personnalisé (ou en bas de la carte si aucun des deux n'est présent). En landscape mode elle est alignée sur le bas de la carte. Tous les éléments du SDK Navigation visibles sur le côté droit (côté droit en LTR) se déplacent vers le haut pour tenir compte de la hauteur de la vue de commande personnalisée. Cette commande est positionnée à l'intérieur des limites visibles de la carte. Par conséquent, toute marge intérieure ajoutée aux bords inférieur ou droit de la carte modifie également la position de cette commande.

Pied de page

Fonctionnalité en preview

Position de la commande personnalisée du pied de page pour l'orientation portrait

Position de la commande personnalisée du pied de page pour l'orientation paysage

Pour utiliser cette position de commande personnalisée, transmettez la position CustomControlPosition.FOOTER à setCustomControl.

Cette position de commande personnalisée est conçue pour une vue de pied de page personnalisée. Si la fiche indiquant l'heure d'arrivée prévue du SDK Navigation est visible, cette commande se trouve au-dessus. Sinon, la commande est alignée sur le bas de la carte. Contrairement aux commandes personnalisées BOTTOM_START_BELOW et BOTTOM_END_BELOW, cette commande est positionnée en dehors des limites visibles de la carte. Cela signifie que toute marge intérieure ajoutée à la carte ne modifie pas la position de cette commande.

En portrait mode, le pied de page personnalisé occupe toute la largeur. Les commandes personnalisées dans les positions CustomControlPosition.BOTTOM_START_BELOW et CustomControlPosition.BOTTOM_END_BELOW, ainsi que les éléments d'interface utilisateur du SDK Navigation tels que le bouton de recentrage et le logo Google, sont positionnés au-dessus du pied de page de la commande personnalisée. La position par défaut du chevron tient compte de la hauteur du pied de page personnalisé.

En landscape mode, le pied de page personnalisé occupe la moitié de la largeur et est aligné sur le côté gauche (côté gauche en LTR), tout comme la fiche indiquant l'heure d'arrivée prévue du SDK Navigation. Les commandes personnalisées dans la position CustomControlPosition.BOTTOM_START_BELOW et les éléments d'interface utilisateur du SDK Navigation tels que le bouton de recentrage et le logo Google sont positionnés au-dessus du pied de page de la commande personnalisée. Les commandes personnalisées dans la position CustomControlPosition.BOTTOM_END_BELOW et tous les éléments d'interface utilisateur du SDK Navigation sur le côté droit (côté droit en LTR) restent alignés sur le bas de la carte. La position par défaut du chevron ne change pas lorsqu'un pied de page personnalisé est présent, car le pied de page ne s'étend pas jusqu'au côté droit de la carte.

Les commandes personnalisées dans les positions CustomControlPosition.BOTTOM_START_BELOW et CustomControlPosition.BOTTOM_END_BELOW, ainsi que les éléments d'interface utilisateur du SDK Navigation tels que le bouton de recentrage et le logo Google, sont positionnés au-dessus du pied de page de la commande personnalisée.

Accessoires d'interface utilisateur de la carte

Le SDK Navigation pour Android fournit des accessoires d'interface utilisateur qui s'affichent pendant la navigation, semblables à ceux de l'application Google Maps pour Android. Vous pouvez ajuster la visibilité ou l'apparence visuelle de ces commandes comme décrit dans cette section. Les modifications que vous apportez ici sont prises en compte lors de la prochaine session de navigation.

Consultez la page Règles pour obtenir des consignes sur les modifications acceptables de l'interface utilisateur de navigation.

Afficher le code

Afficher/masquer le code Java de l'activité de navigation

package com.example.navsdkcustomization;

import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.CameraPerspective;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.Navigator;
import com.google.android.libraries.navigation.SimulationOptions;
import com.google.android.libraries.navigation.StylingOptions;
import com.google.android.libraries.navigation.SupportNavigationFragment;
import com.google.android.libraries.navigation.Waypoint;

/** An activity that displays a map and a customized navigation UI. */
public class NavigationActivityCustomization extends AppCompatActivity {

  private static final String TAG = NavigationActivityCustomization.class.getSimpleName();
  private Navigator mNavigator;
  private SupportNavigationFragment mNavFragment;
  private GoogleMap mMap;
  // Define the Sydney Opera House by specifying its place ID.
  private static final String SYDNEY_OPERA_HOUSE = "ChIJ3S-JXmauEmsRUcIaWtf4MzE";
  // Set fields for requesting location permission.
  private static final int PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1;
  private boolean mLocationPermissionGranted;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Navigation SDK.
    initializeNavigationSdk();
  }

  /**
   * Starts the Navigation SDK and sets the camera to follow the device's location. Calls the
   * navigateToPlace() method when the navigator is ready.
   */
  private void initializeNavigationSdk() {
    /*
     * Request location permission, so that we can get the location of the
     * device. The result of the permission request is handled by a callback,
     * onRequestPermissionsResult.
     */
    if (ContextCompat.checkSelfPermission(
            this.getApplicationContext(), android.Manifest.permission.ACCESS_FINE_LOCATION)
        == PackageManager.PERMISSION_GRANTED) {
      mLocationPermissionGranted = true;
    } else {
      ActivityCompat.requestPermissions(
          this,
          new String[] {android.Manifest.permission.ACCESS_FINE_LOCATION},
          PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
    }

    if (!mLocationPermissionGranted) {
      displayMessage(
          "Error loading Navigation SDK: " + "The user has not granted location permission.");
      return;
    }

    // Get a navigator.
    NavigationApi.getNavigator(
        this,
        new NavigationApi.NavigatorListener() {
          /** Sets up the navigation UI when the navigator is ready for use. */
          @Override
          public void onNavigatorReady(Navigator navigator) {
            displayMessage("Navigator ready.");
            mNavigator = navigator;
            mNavFragment =
                (SupportNavigationFragment)
                    getSupportFragmentManager().findFragmentById(R.id.navigation_fragment);

            // Get the map.
            mNavFragment.getMapAsync(
                new OnMapReadyCallback() {
                  @Override
                  public void onMapReady(GoogleMap map) {
                    mMap = map;
                    // Navigate to a place, specified by Place ID.
                    navigateToPlace(SYDNEY_OPERA_HOUSE);
                  }
                });
          }

          /**
           * Handles errors from the Navigation SDK.
           *
           * @param errorCode The error code returned by the navigator.
           */
          @Override
          public void onError(@NavigationApi.ErrorCode int errorCode) {
            switch (errorCode) {
              case NavigationApi.ErrorCode.NOT_AUTHORIZED:
                displayMessage(
                    "Error loading Navigation SDK: Your API key is "
                        + "invalid or not authorized to use the Navigation SDK.");
                break;
              case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                displayMessage(
                    "Error loading Navigation SDK: User did not accept "
                        + "the Navigation Terms of Use.");
                break;
              case NavigationApi.ErrorCode.NETWORK_ERROR:
                displayMessage("Error loading Navigation SDK: Network error.");
                break;
              case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                displayMessage(
                    "Error loading Navigation SDK: Location permission " + "is missing.");
                break;
              default:
                displayMessage("Error loading Navigation SDK: " + errorCode);
            }
          }
        });
  }

  /** Customizes the navigation UI and the map. */
  private void customizeNavigationUI() {
    // Set custom colors for the navigator.
    mNavFragment.setStylingOptions(
        new StylingOptions()
            .primaryDayModeThemeColor(0xff1A237E)
            .secondaryDayModeThemeColor(0xff3F51B5)
            .primaryNightModeThemeColor(0xff212121)
            .secondaryNightModeThemeColor(0xff424242)
            .headerLargeManeuverIconColor(0xffffff00)
            .headerSmallManeuverIconColor(0xffffa500)
            .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerNextStepTextColor(0xff00ff00)
            .headerNextStepTextSize(20f)
            .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
            .headerDistanceValueTextColor(0xff00ff00)
            .headerDistanceUnitsTextColor(0xff0000ff)
            .headerDistanceValueTextSize(20f)
            .headerDistanceUnitsTextSize(18f)
            .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerInstructionsTextColor(0xffffff00)
            .headerInstructionsFirstRowTextSize(24f)
            .headerInstructionsSecondRowTextSize(20f)
            .headerGuidanceRecommendedLaneColor(0xffffa500));

    mMap.setTrafficEnabled(false);

    // Place a marker at the final destination.
    if (mNavigator.getCurrentRouteSegment() != null) {
      LatLng destinationLatLng = mNavigator.getCurrentRouteSegment().getDestinationLatLng();

      Bitmap destinationMarkerIcon =
          BitmapFactory.decodeResource(getResources(), R.drawable.ic_person_pin_48dp);

      mMap.addMarker(
          new MarkerOptions()
              .position(destinationLatLng)
              .icon(BitmapDescriptorFactory.fromBitmap(destinationMarkerIcon))
              .title("Destination marker"));

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

              // The event has been handled.
              return true;
            }
          });
    }

    // Set the camera to follow the device location with 'TILTED' driving view.
    mMap.followMyLocation(CameraPerspective.TILTED);
  }

  /**
   * Requests directions from the user's current location to a specific place (provided by the
   * Google Places API).
   */
  private void navigateToPlace(String placeId) {
    Waypoint destination;
    try {
      destination =
          Waypoint.builder().setPlaceIdString(placeId).build();
    } catch (Waypoint.UnsupportedPlaceIdException e) {
      displayMessage("Error starting navigation: Place ID is not supported.");
      return;
    }

    // Create a future to await the result of the asynchronous navigator task.
    ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
        mNavigator.setDestination(destination);

    // Define the action to perform when the SDK has determined the route.
    pendingRoute.setOnResultListener(
        new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
          @Override
          public void onResult(Navigator.RouteStatus code) {
            switch (code) {
              case OK:
                // Hide the toolbar to maximize the navigation UI.
                if (getActionBar() != null) {
                  getActionBar().hide();
                }

                // Customize the navigation UI.
                customizeNavigationUI();

                // Enable voice audio guidance (through the device speaker).
                mNavigator.setAudioGuidance(Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE);

                // Simulate vehicle progress along the route for demo/debug builds.
                if (BuildConfig.DEBUG) {
                  mNavigator
                      .getSimulator()
                      .simulateLocationsAlongExistingRoute(
                          new SimulationOptions().speedMultiplier(5));
                }

                // Start turn-by-turn guidance along the current route.
                mNavigator.startGuidance();
                break;
              // Handle error conditions returned by the navigator.
              case NO_ROUTE_FOUND:
                displayMessage("Error starting navigation: No route found.");
                break;
              case NETWORK_ERROR:
                displayMessage("Error starting navigation: Network error.");
                break;
              case ROUTE_CANCELED:
                displayMessage("Error starting navigation: Route canceled.");
                break;
              default:
                displayMessage("Error starting navigation: " + String.valueOf(code));
            }
          }
        });
  }

  /** Handles the result of the request for location permissions. */
  @Override
  public void onRequestPermissionsResult(
      int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    mLocationPermissionGranted = false;
    switch (requestCode) {
      case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION:
        {
          // If request is canceled, the result arrays are empty.
          if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            mLocationPermissionGranted = true;
          }
        }
    }
  }

  /**
   * Shows a message on screen and in the log. Used when something goes wrong.
   *
   * @param errorMessage The message to display.
   */
  private void displayMessage(String errorMessage) {
    Toast.makeText(this, errorMessage, Toast.LENGTH_LONG).show();
    Log.d(TAG, errorMessage);
  }
}

Mise en surbrillance de la destination et entrées

Lorsqu'une destination est créée avec un placeID, le bâtiment de destination est mis en surbrillance et une icône d'entrée s'affiche, dans la mesure du possible. Ces repères visuels aident les utilisateurs à distinguer leur destination et à s'y rendre.

Pour créer une destination avec un placeID, utilisez la Waypoint.Builder.setPlaceIdString() méthode.

Remarque : Le SDK Navigation n'est pas compatible avec la navigation en intérieur. Pour les cartes d'intérieur sans navigation, utilisez les indoorBuilding et indoorLevel classes du SDK Maps pour Android.

Modifier l'en-tête de navigation

Utilisez SupportNavigationFragment.setStylingOptions() ou NavigationView.setStylingOptions() pour modifier le thème de l'en-tête de navigation et l'indicateur de prochain virage qui s'affiche sous l'en-tête lorsqu'il est disponible.

Remarque : La hauteur par défaut de l'en-tête est dynamique et est dimensionnée en fonction des instructions de manœuvre affichées.

Vous pouvez définir les attributs suivants :

Type d'attribut	Attributs
Couleur de l'arrière-plan	Mode Jour principal : couleur de l'en-tête de navigation pendant la journée Mode Jour secondaire : couleur de l'indicateur de prochain virage pendant la journée Mode Nuit principal : couleur de l'en-tête de navigation pendant la nuit Mode Nuit secondaire : couleur de l'indicateur de prochain virage pendant la nuit
Éléments de texte pour les instructions	Couleur du texte Police Taille du texte de la première ligne Taille du texte de la deuxième ligne
Éléments de texte pour les étapes suivantes	Police Couleur du texte de la valeur de distance Taille du texte de la valeur de distance Couleur du texte des unités de distance Taille du texte des unités de distance
Icônes de manœuvre	Couleur de l'icône de manœuvre de grande taille Couleur de l'icône de manœuvre de petite taille
Assistant de voies de circulation	Couleur de la ou des voies recommandées

L'exemple suivant montre comment définir des options de style :

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

Désactiver le calque de trafic

Utilisez GoogleMap.setTrafficEnabled() pour activer ou désactiver le calque de trafic sur la carte. Ce paramètre affecte les indications de densité du trafic affichées sur l'ensemble de la carte. Toutefois, il n'affecte pas les indications de trafic sur l'itinéraire tracé par le navigateur.

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

Activer les feux de circulation et les panneaux stop

Vous pouvez activer l'affichage des feux de circulation et des panneaux stop sur la carte pendant la navigation active, ce qui fournit un contexte supplémentaire pour les itinéraires et les manœuvres de trajet.

Par défaut, les feux de circulation et les panneaux stop sont désactivés dans le SDK Navigation. Pour activer cette fonctionnalité, appelez DisplayOptions pour chaque fonctionnalité indépendamment.

Remarque : Les feux de circulation peuvent également apparaître sur la carte en mode non navigation. L'option permettant de configurer l'affichage des feux de circulation à l'aide de DisplayOptions n'affecte que les feux de circulation en mode navigation active.

L'exemple suivant montre comment masquer les feux de circulation et les panneaux stop :

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

Les méthodes showTrafficLights(boolean) et showStopSigns(boolean) sont obsolètes et seront supprimées dans la prochaine version majeure. Les feux de circulation et les panneaux stop seront affichés par défaut.

Ajouter des repères personnalisés

Le SDK Navigation pour Android utilise désormais les API Google Maps pour les repères. Pour en savoir plus, consultez la documentation de l'API Maps.

Texte flottant

Vous pouvez ajouter du texte flottant n'importe où dans votre application, à condition qu'il ne couvre pas l'attribution Google. Le SDK Navigation n'est pas compatible avec l'ancrage du texte à une latitude/longitude sur la carte ni à un libellé. Pour en savoir plus, consultez Info windows.

Afficher la limitation de vitesse

Vous pouvez afficher ou masquer l'icône de limitation de vitesse par programmation. Utilisez NavigationView.setSpeedLimitIconEnabled() ou SupportNavigationFragment.setSpeedLimitIconEnabled() pour afficher ou masquer l'icône de limitation de vitesse. Lorsqu'elle est activée, l'icône de limitation de vitesse s'affiche dans un angle inférieur pendant le guidage. L'icône affiche la limitation de vitesse de la route sur laquelle le véhicule circule. L'icône n'apparaît que dans les zones où des données fiables sur la limitation de vitesse sont disponibles.

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

L'icône de limitation de vitesse est temporairement masquée lorsque le bouton de recentrage s'affiche.

Remarque : Les utilisateurs doivent respecter tous les panneaux de signalisation affichés sur la route. Les données affichées dans l'icône de limitation de vitesse ne sont fournies qu'à titre indicatif. L'exactitude des données sur la limitation de vitesse ne peut pas être garantie. Vous pouvez signaler des inexactitudes dans nos données sur la limitation de vitesse en créant un ticket sur la page de l'assistance Google Cloud.

Activer le mode Nuit

Vous pouvez contrôler le comportement du mode Nuit par programmation. Utilisez NavigationView.setForceNightMode() ou SupportNavigationFragment.setForceNightMode() pour activer ou désactiver le mode Nuit, ou laissez le SDK Navigation pour Android le contrôler.

• AUTO permet au SDK Navigation de déterminer le mode approprié en fonction de la position de l'appareil et de l'heure locale.
• FORCE_NIGHT force l'activation du mode Nuit.
• FORCE_DAY force l'activation du mode Jour.

L'exemple suivant montre comment forcer l'activation du mode Nuit dans un fragment de navigation :

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

Afficher la liste des itinéraires

Tout d'abord, créez la vue et ajoutez-la à votre hiérarchie.

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

Veillez à transmettre les événements de cycle de vie à DirectionsListView, comme c'est le cas avec NavigationView. Exemple :

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

Masquer les itinéraires bis

Avertissement : Cette fonctionnalité n'est pas compatible avec la fonctionnalité d'itinéraire le plus court/le plus rapide. L'utilisation simultanée des deux fonctionnalités peut entraîner un comportement inattendu.

Lorsque l'interface utilisateur est encombrée par trop d'informations, vous pouvez réduire l'encombrement en affichant moins d'itinéraires bis que la valeur par défaut (deux) ou en n'affichant aucun itinéraire bis. Vous pouvez configurer cette option avant d'extraire les itinéraires en appelant la méthode RoutingOptions.alternateRoutesStrategy() avec l'une des valeurs d'énumération suivantes :

Valeur d'énumération	Description
AlternateRoutesStrategy.SHOW_ALL	Valeur par défaut. Affiche jusqu'à deux itinéraires bis.
AlternateRoutesStrategy.SHOW_ONE	Affiche un itinéraire bis (si disponible).
AlternateRoutesStrategy.SHOW_NONE	Masque les itinéraires bis.

L'exemple de code suivant montre comment masquer complètement les itinéraires bis.

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

Barre de progression du trajet

Fonctionnalité expérimentale

La barre de progression du trajet est une barre verticale qui s'affiche sur le côté gauche/principal de la carte au début de la navigation. Lorsqu'elle est activée, elle affiche un aperçu de l'ensemble du trajet, ainsi que la destination et la position actuelle de l'utilisateur.

La permet aux utilisateurs d'anticiper rapidement les problèmes à venir, tels que le trafic, sans avoir à effectuer de zoom avant. Ils peuvent ensuite modifier l'itinéraire si nécessaire. Si l'utilisateur modifie l'itinéraire, la barre de progression est réinitialisée comme si un nouveau trajet avait commencé à partir de ce point.

La barre de progression du trajet affiche les indicateurs d'état suivants :

• Trajet écoulé : partie du trajet écoulée.

• Position actuelle : position actuelle de l'utilisateur dans le trajet.

• État du trafic : état du trafic à venir.

• Destination finale : destination finale du trajet.

Activez la barre de progression du trajet en appelant la setTripProgressBarEnabled() méthode sur NavigationView ou SupportNavigationFragment. Exemple :

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

Positionnement de la barre de progression du trajet

• Le côté gauche de la barre est à peu près aligné sur le côté gauche du compteur de vitesse, du logo Google et du bouton de recentrage (lorsqu'il est visible). La largeur est de 12 dp.
• La barre de progression du trajet conserve une hauteur statique. Afin de s'adapter aux limites d'espace vertical sur les appareils plus petits, la visibilité et la hauteur de la barre de progression du trajet s'adaptent en fonction des points d'arrêt spécifiés dans la hauteur de l'écran. Ces points d'arrêt sont indépendants de l'orientation de l'appareil et de l'espace réellement occupé par la carte à l'écran :

Hauteur de l'écran	Visibilité de la barre de progression du trajet	Hauteur de la barre de progression du trajet	Position de la barre de progression du trajet sur l'axe Y
Petite : 0 dp - 551 dp	Non visible	N/A	N/A
Moyenne : 552 dp - 739 dp	Visible	130 dp	Au-dessus des commandes du côté gauche (compteur de vitesse / logo Google / bouton de recentrage)
Grande : 740 dp et plus	Visible	290 dp	Au-dessus des commandes du côté gauche (compteur de vitesse / logo Google / bouton de recentrage)

Remarque : Les valeurs de hauteur d'écran affichées dans le tableau ci-dessus s'appliquent aux versions 6.2.1 et ultérieures du SDK Navigation. Pour la version 6.2.0, les petits écrans sont définis comme 0 dp - 519 dp, les écrans moyens comme 520 dp - 599 dp et les grands écrans comme 600 dp et plus. La visibilité, la hauteur et la position sur l'axe Y de la barre de progression du trajet sont les mêmes.
• Si la barre de progression du trajet se chevauche avec la fiche de virage ou d'autres éléments d'interface utilisateur de navigation, elle apparaît sous ces autres éléments.

Boussole

Le SDK Navigation fournit une image de boussole qui apparaît dans l'angle supérieur droit de la carte, dans certaines conditions et uniquement lorsqu'elle est activée. Lorsque l'utilisateur clique sur la boussole, la caméra s'anime pour revenir à une direction de zéro (orientation par défaut) et la boussole disparaît progressivement juste après.

Si la navigation est activée et que le mode caméra est défini sur "Suivre", la boussole reste visible. Appuyer sur la boussole permet de basculer entre les perspectives de la caméra inclinée et de la caméra de vue d'ensemble.

Pour éviter de distraire le conducteur, la boussole reste dans la même position si l'en-tête (en mode Portrait) se développe et entre en conflit avec la position par défaut de la boussole. Si vous ajoutez une commande personnalisée d'en-tête secondaire ou une vue d'accessoire d'en-tête, la boussole est masquée pour éviter les conflits d'interface utilisateur.

La boussole est compatible avec les modes Jour et Nuit, ainsi qu'avec le mode Sombre.

La boussole est activée par défaut. Vous pouvez définir si la boussole est activée à l'aide de la compassEnabled méthode sur la GoogleMapOptions classe.

Désactiver les bâtiments 3D

Pour les appareils aux performances limitées, vous pouvez désactiver l'affichage des bâtiments 3D en appelant GoogleMap.setBuildingsEnabled(false).

API de visibilité des invites (expérimentale)

Fonctionnalité expérimentale

L'API de visibilité des invites vous permet d'éviter les conflits entre les éléments d'interface utilisateur générés par le SDK Navigation et vos propres éléments d'interface utilisateur personnalisés en ajoutant un écouteur pour recevoir un rappel avant qu'un élément d'interface utilisateur du SDK Navigation ne s'affiche et dès que l'élément est supprimé. Pour en savoir plus, y compris des exemples de code, consultez la section API de visibilité des invites de la page Configurer les perturbations en temps réel.