En esta página

routeManeuver QML Type

El tipo routeManeuver representa la información relevante para el punto en el que se encuentran dos routeSegments. Más...

Import Statement: import QtLocation 6.11
Since: QtLocation 5.5

Propiedades

Descripción detallada

Las instancias de routeSegment pueden considerarse como aristas de un grafo de rutas, con instancias de routeManeuver como etiquetas opcionales adjuntas a los vértices del grafo.

La información más interesante contenida en una instancia de routeManeuver es normalmente la navegación textual a proporcionar y la posición en la que proporcionarla, accesibles mediante instructionText y position respectivamente.

Ejemplo

El siguiente fragmento QML demuestra cómo imprimir 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."
}

Propiedad Documentación

direction : enumeration

Describe el cambio de dirección asociado al texto de instrucción que está asociado a 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 del viaje
  • RouteManeuver.DirectionBearRight - La instrucción indica que la dirección del viaje debe ser hacia la derecha.
  • RouteManeuver.DirectionLightRight - La instrucción indica que es necesario girar ligeramente a la derecha
  • RouteManeuver.DirectionRight - La instrucción indica que es necesario girar a la derecha
  • RouteManeuver.DirectionHardRight - La instrucción indica que se requiere un giro duro a la derecha
  • RouteManeuver.DirectionUTurnRight - La instrucción indica que se requiere un giro en U a la derecha
  • RouteManeuver.DirectionUTurnLeft - La instrucción indica que se requiere un giro en U a la izquierda
  • RouteManeuver.DirectionHardLeft - La instrucción indica que se requiere un giro cerrado a la izquierda
  • RouteManeuver.DirectionLeft - La instrucción indica que se requiere un giro a la izquierda
  • RouteManeuver.DirectionLightLeft - La instrucción indica que se requiere un giro suave a la izquierda
  • RouteManeuver.DirectionBearLeft - La instrucción indica que la dirección de la marcha debe ser hacia la izquierda

distanceToNextInstruction : real

Esta propiedad de sólo 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 extendidos de la maniobra y es un mapa. Estos atributos son específicos del plugin y pueden estar vacíos.

Consulte la documentación del plugin para saber qué atributos son compatibles y cómo deben utilizarse.

Nota, debido a las limitaciones de QQmlPropertyMap, no es posible especificar declarativamente los atributos en QML, la asignación de claves y valores de atributos sólo puede realizarse mediante JavaScript.

Esta propiedad se introdujo en QtLocation 5.11.

instructionText : string

Esta propiedad de sólo lectura contiene instrucciones de navegación textuales.

position : coordinate

Esta propiedad de sólo lectura indica dónde debe mostrarse instructionText.

timeToNextInstruction : int

Esta propiedad de sólo lectura contiene el tiempo estimado, en segundos, que se tardará en viajar desde el punto en el que se emitió la instrucción asociada hasta el punto en el que debería emitirse la siguiente instrucción, en segundos.

valid : bool

Esta propiedad de sólo lectura contiene si esta maniobra es válida o no.

Las maniobras no válidas se utilizan cuando no hay información que deba adjuntarse al punto final de una instancia de QGeoRouteSegment.

waypoint : coordinate

Esta propiedad contiene el waypoint asociado a esta maniobra. No todas las maniobras tienen un waypoint 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.