routeManeuver QML Type
El tipo «routeManeuver» representa la información relevante sobre el punto en el que se unen dos «routeSegments». Más información...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
Propiedades
- direction : enumeration
- distanceToNextInstruction : real
- extendedAttributes : Object
(since QtLocation 5.11) - instructionText : string
- position : coordinate
- timeToNextInstruction : int
- valid : bool
- waypoint : coordinate
Descripción detallada
Las instancias de ` routeSegment ` pueden considerarse como aristas de un grafo de enrutamiento, mientras que las instancias de `routeManeuver` son etiquetas opcionales asociadas a los vértices del grafo.
La información más interesante que contiene una instancia de «routeManeuver» suele ser la indicación textual que se debe proporcionar y la posición en la que debe proporcionarse, a las que se accede mediante « instructionText » y « position », respectivamente.
Ejemplo
El siguiente fragmento de código QML muestra cómo mostrar información sobre una maniobra de ruta:
import QtQuick
import QtPositioning
import QtLocation
Text {
text: "Distance till next maneuver: " + routeManeuver.distanceToNextInstruction
+ " meters, estimated time: " + routeManeuver.timeToNextInstruction + " seconds."
}Documentación de propiedades
direction : enumeration
Describe el cambio de dirección asociado al texto de la instrucción que se relaciona con un « routeManeuver ».
- RouteManeuver.NoDirection: no hay ninguna dirección asociada al texto de la instrucción
- RouteManeuver.DirectionForward: la instrucción indica que no es necesario cambiar la dirección de marcha
- RouteManeuver.DirectionBearRight: la instrucción indica que la dirección de marcha debe inclinarse hacia la derecha
- RouteManeuver.DirectionLightRight: la instrucción indica que es necesario un ligero giro a la derecha
- RouteManeuver.DirectionRight: la instrucción indica que es necesario girar a la derecha
- RouteManeuver.DirectionHardRight: la instrucción indica que es necesario realizar un giro brusco a la derecha
- RouteManeuver.DirectionUTurnRight: la instrucción indica que es necesario realizar un giro en U hacia la derecha
- RouteManeuver.DirectionUTurnLeft: la instrucción indica que es necesario realizar un giro en U hacia la izquierda
- RouteManeuver.DirectionHardLeft: la instrucción indica que es necesario realizar un giro brusco a la izquierda
- RouteManeuver.DirectionLeft: la instrucción indica que es necesario girar a la izquierda
- RouteManeuver.DirectionLightLeft: la instrucción indica que es necesario realizar un giro suave a la izquierda
- RouteManeuver.DirectionBearLeft: la instrucción indica que la dirección de la marcha debe inclinarse hacia la izquierda
distanceToNextInstruction : real
Esta propiedad de solo lectura contiene la distancia, en metros, entre el punto en el que se emitió la instrucción asociada y el punto en el que debería emitirse la siguiente instrucción.
extendedAttributes : Object [since QtLocation 5.11]
Esta propiedad contiene los atributos ampliados de la maniobra y es un mapa. Estos atributos son específicos del complemento y pueden estar vacíos.
Consulta la documentación del complemento para saber qué atributos son compatibles y cómo deben utilizarse.
Ten en cuenta que, debido a las limitaciones de QQmlPropertyMap, no es posible especificar los atributos de forma declarativa en QML; la asignación de claves y valores a los atributos solo puede realizarse mediante JavaScript.
Esta propiedad se introdujo en QtLocation 5.11.
instructionText : string
Esta propiedad de solo lectura contiene instrucciones de navegación en formato de texto.
position : coordinate
Esta propiedad de solo lectura indica dónde debe mostrarse el « instructionText ».
timeToNextInstruction : int
Esta propiedad de solo lectura contiene el tiempo estimado, en segundos, que tardará en transcurrir desde el momento en que se emitió la instrucción asociada hasta el momento en que debería emitirse la siguiente instrucción, en segundos.
valid : bool
Esta propiedad de solo lectura indica si esta maniobra es válida o no.
Las maniobras no válidas se utilizan cuando no hay información que deban adjuntarse al punto final de una instancia de ` QGeoRouteSegment `.
waypoint : coordinate
Esta propiedad contiene el punto de ruta asociado a esta maniobra. No todas las maniobras tienen un punto de ruta asociado.
© 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.