Sur cette page

routeManeuver QML Type

Le type « routeManeuver » représente les informations relatives au point de jonction entre deux « routeSegments ». En savoir plus...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propriétés

Description détaillée

Les instances de ` routeSegment ` peuvent être considérées comme des arêtes d'un graphe de routage, les instances de `routeManeuver` étant des étiquettes facultatives associées aux sommets du graphe.

Les informations les plus intéressantes contenues dans une instance `routeManeuver` sont généralement le message de navigation à fournir et la position à laquelle il doit l’être, accessibles respectivement via les méthodes ` instructionText ` et ` position `.

Exemple

L'extrait de code QML suivant montre comment afficher des informations sur une manœuvre d’itinéraire :

import QtQuick
import QtPositioning
import QtLocation

Text {
    text: "Distance till next maneuver: " + routeManeuver.distanceToNextInstruction
          + " meters, estimated time: " + routeManeuver.timeToNextInstruction + " seconds."
}

Documentation des propriétés

direction : enumeration

Décrit le changement de direction associé au texte d'instruction lié à une instruction « routeManeuver ».

  • RouteManeuver.NoDirection - Aucune direction n'est associée au texte d'instruction
  • RouteManeuver.DirectionForward - L’instruction indique que le sens de circulation n’a pas besoin de changer
  • RouteManeuver.DirectionBearRight - L'instruction indique que la direction de déplacement doit s'orienter vers la droite
  • RouteManeuver.DirectionLightRight - L'instruction indique qu'un léger virage vers la droite est nécessaire
  • RouteManeuver.DirectionRight - L’instruction indique qu’un virage à droite est requis
  • RouteManeuver.DirectionHardRight - L'instruction indique qu'un virage serré vers la droite est requis
  • RouteManeuver.DirectionUTurnRight - L'instruction indique qu'un demi-tour vers la droite est requis
  • RouteManeuver.DirectionUTurnLeft - Cette instruction indique qu'un demi-tour vers la gauche est requis
  • RouteManeuver.DirectionHardLeft - L'instruction indique qu'un virage serré à gauche est requis
  • RouteManeuver.DirectionLeft - Cette instruction indique qu'un virage à gauche est nécessaire
  • RouteManeuver.DirectionLightLeft - Cette instruction indique qu'un léger virage à gauche est nécessaire
  • RouteManeuver.DirectionBearLeft - Cette instruction indique que la direction de la marche doit s'orienter vers la gauche

distanceToNextInstruction : real

Cette propriété en lecture seule indique la distance, en mètres, entre le point où l'instruction associée a été émise et le point où l'instruction suivante doit être émise.

extendedAttributes : Object [since QtLocation 5.11]

Cette propriété contient les attributs étendus de la manœuvre et se présente sous la forme d'une carte. Ces attributs sont spécifiques au plugin et peuvent être vides.

Consultez la documentation du plugin pour connaître les attributs pris en charge et leur mode d'utilisation.

Remarque : en raison des limitations de l’ QQmlPropertyMap, il n’est pas possible de spécifier les attributs de manière déclarative en QML ; l’affectation des clés et des valeurs d’attributs ne peut être effectuée qu’en JavaScript.

Cette propriété a été introduite dans QtLocation 5.11.

instructionText : string

Cette propriété en lecture seule contient des instructions de navigation sous forme de texte.

position : coordinate

Cette propriété en lecture seule indique l'emplacement où l'instructionText s doit s'afficher.

timeToNextInstruction : int

Cette propriété en lecture seule contient l'estimation, en secondes, du temps nécessaire pour passer du moment où l'instruction associée a été émise au moment où l'instruction suivante devrait être émise.

valid : bool

Cette propriété en lecture seule indique si cette manœuvre est valide ou non.

Les manœuvres non valides sont utilisées lorsqu'aucune information ne doit être associée au point de terminaison d'une instance de ` QGeoRouteSegment `.

waypoint : coordinate

Cette propriété contient le point de passage associé à cette manœuvre. Toutes les manœuvres ne sont pas associées à un point de passage.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.