En esta página

QGeoManeuver Class

La clase `QGeoManeuver` representa la información relevante sobre el punto en el que se unen dos `QGeoRouteSegments`. Más información...

Header: #include <QGeoManeuver>
qmake: QT += location

Tipos públicos

enum InstructionDirection { NoDirection, DirectionForward, DirectionBearRight, DirectionLightRight, DirectionRight, …, DirectionBearLeft }

Propiedades

Funciones públicas

QGeoManeuver()
QGeoManeuver(const QGeoManeuver &other)
QGeoManeuver(QGeoManeuver &&other)
~QGeoManeuver()
QGeoManeuver::InstructionDirection direction() const
qreal distanceToNextInstruction() const
QVariantMap extendedAttributes() const
QString instructionText() const
bool isValid() const
QGeoCoordinate position() const
int timeToNextInstruction() const
QGeoCoordinate waypoint() const
QGeoManeuver &operator=(const QGeoManeuver &other)
bool operator!=(const QGeoManeuver &lhs, const QGeoManeuver &rhs)
bool operator==(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

Descripción detallada

QGeoRouteSegment Las instancias pueden considerarse como aristas de un grafo de rutas, siendo las instancias de QGeoManeuver etiquetas opcionales asociadas a los vértices del grafo.

La información más interesante que contiene una instancia de QGeoManeuver suele ser el texto de navegación que se va a proporcionar y la posición en la que se va a proporcionar, a los que se puede acceder mediante instructionText() y position(), respectivamente.

También es posible determinar si se ha superado un punto de ruta comprobando si waypoint() devuelve un QGeoCoordinate válido.

Documentación sobre los tipos de miembro

enum QGeoManeuver::InstructionDirection

Describe el cambio de dirección asociado al texto de instrucciones vinculado a un QGeoManaeuver.

ConstanteValorDescripción
QGeoManeuver::NoDirection0No hay ninguna dirección asociada al texto de la instrucción.
QGeoManeuver::DirectionForward1La instrucción indica que no es necesario cambiar la dirección de desplazamiento.
QGeoManeuver::DirectionBearRight2La indicación indica que la dirección de marcha debe girar hacia la derecha.
QGeoManeuver::DirectionLightRight3La indicación señala que es necesario realizar un giro suave hacia la derecha.
QGeoManeuver::DirectionRight4La indicación indica que es necesario girar a la derecha.
QGeoManeuver::DirectionHardRight5La indicación señala que es necesario realizar un giro brusco a la derecha.
QGeoManeuver::DirectionUTurnRight6La indicación señala que hay que dar la vuelta hacia la derecha.
QGeoManeuver::DirectionUTurnLeft7La indicación señala que hay que dar la vuelta en U hacia la izquierda.
QGeoManeuver::DirectionHardLeft8La indicación señala que hay que girar bruscamente a la izquierda.
QGeoManeuver::DirectionLeft9La indicación señala que hay que girar a la izquierda.
QGeoManeuver::DirectionLightLeft10La indicación señala que hay que girar ligeramente a la izquierda.
QGeoManeuver::DirectionBearLeft11La indicación señala que la dirección de marcha debe ser hacia la izquierda.

Documentación de la propiedad

[read-only] direction : const InstructionDirection

Esta propiedad contiene la dirección asociada a la instrucción correspondiente.

Funciones de acceso:

QGeoManeuver::InstructionDirection direction() const

[read-only] distanceToNextInstruction : const qreal

Esta propiedad indica la distancia, en metros, entre el punto en el que se emitió esta instrucción y el punto en el que debería emitirse la siguiente instrucción.

Funciones de acceso:

qreal distanceToNextInstruction() const

[read-only, since QtLocation 5.11] extendedAttributes : const QVariantMap

Esta propiedad contiene los atributos extendidos asociados a esta maniobra.

Esta enumeración se introdujo en QtLocation 5.11.

Funciones de acceso:

QVariantMap extendedAttributes() const

[read-only] instructionText : const QString

Esta propiedad contiene las instrucciones de navegación en formato de texto.

Funciones de acceso:

QString instructionText() const

[read-only] position : const QGeoCoordinate

Esta propiedad define la posición en la que debe mostrarse instructionText.

Funciones de acceso:

QGeoCoordinate position() const

[read-only] timeToNextInstruction : const int

Esta propiedad 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.

Funciones de acceso:

int timeToNextInstruction() const

[read-only] valid : const bool

Esta propiedad 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.

Funciones de acceso:

bool isValid() const

[read-only] waypoint : const QGeoCoordinate

Esta propiedad contiene el punto de ruta asociado a esta maniobra.

Si no hay ningún punto de ruta asociado a esta maniobra, esta propiedad contiene un valor no válido « QGeoCoordinate ».

Funciones de acceso:

QGeoCoordinate waypoint() const

Documentación de las funciones de miembro

QGeoManeuver::QGeoManeuver()

Crea un objeto de maniobra no válido.

La maniobra seguirá siendo inválida hasta que se llame a una de las siguientes funciones: setPosition(), setInstructionText(), setDirection(), setTimeToNextInstruction(), setDistanceToNextInstruction() o setWaypoint().

[noexcept] QGeoManeuver::QGeoManeuver(const QGeoManeuver &other)

Crea un objeto de maniobra a partir del contenido de ` other`.

[constexpr noexcept default] QGeoManeuver::QGeoManeuver(QGeoManeuver &&other)

Crea una instancia de ` QGeoManeuver` mediante la construcción «move».

[noexcept] QGeoManeuver::~QGeoManeuver()

Destruye este objeto de maniobra.

QGeoManeuver &QGeoManeuver::operator=(const QGeoManeuver &other)

Asigna « other » a este objeto de maniobra y, a continuación, devuelve una referencia a dicho objeto.

Elementos no miembros relacionados

[noexcept] bool operator!=(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

Devuelve si la maniobra « lhs » no es igual a « rhs ».

[noexcept] bool operator==(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

Devuelve si la maniobra « lhs » es igual a « rhs ».

© 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.