QGeoManeuver Class

The QGeoManeuver class represents the information relevant to the point at which two QGeoRouteSegments meet. More...

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

• List of all members, including inherited members

Public Types

enum	InstructionDirection { NoDirection, DirectionForward, DirectionBearRight, DirectionLightRight, ..., DirectionBearLeft }

Public Functions

	QGeoManeuver()
	QGeoManeuver(const QGeoManeuver &other)
	~QGeoManeuver()
QGeoManeuver::InstructionDirection	direction() const
qreal	distanceToNextInstruction() const
QVariantMap	extendedAttributes() const
QString	instructionText() const
bool	isValid() const
QGeoCoordinate	position() const
void	setDirection(QGeoManeuver::InstructionDirection direction)
void	setDistanceToNextInstruction(qreal distance)
void	setExtendedAttributes(const QVariantMap &extendedAttributes)
void	setInstructionText(const QString &instructionText)
void	setPosition(const QGeoCoordinate &position)
void	setTimeToNextInstruction(int secs)
void	setWaypoint(const QGeoCoordinate &coordinate)
int	timeToNextInstruction() const
QGeoCoordinate	waypoint() const
bool	operator!=(const QGeoManeuver &other) const
QGeoManeuver &	operator=(const QGeoManeuver &other)
bool	operator==(const QGeoManeuver &other) const

Protected Functions

QGeoManeuver(const QSharedDataPointer<QGeoManeuverPrivate> &dd)

Detailed Description

The QGeoManeuver class represents the information relevant to the point at which two QGeoRouteSegments meet.

QGeoRouteSegment instances can be thought of as edges on a routing graph, with QGeoManeuver instances as optional labels attached to the vertices of the graph.

The most interesting information help in a QGeoManeuver instance is normally the textual navigation to provide and the position at which to provide it, accessible by instructionText() and position() respectively.

It is also possible to determine if a routing waypoint has been passed by checking if waypoint() returns a valid QGeoCoordinate.

Member Type Documentation

enum QGeoManeuver::InstructionDirection

Describes the change in direction associated with the instruction text that is associated with a QGeoManaeuver.

Constant	Value	Description
QGeoManeuver::NoDirection	0	There is no direction associated with the instruction text.
QGeoManeuver::DirectionForward	1	The instruction indicates that the direction of travel does not need to change.
QGeoManeuver::DirectionBearRight	2	The instruction indicates that the direction of travel should bear to the right.
QGeoManeuver::DirectionLightRight	3	The instruction indicates that a light turn to the right is required.
QGeoManeuver::DirectionRight	4	The instruction indicates that a turn to the right is required.
QGeoManeuver::DirectionHardRight	5	The instruction indicates that a hard turn to the right is required.
QGeoManeuver::DirectionUTurnRight	6	The instruction indicates that a u-turn to the right is required.
QGeoManeuver::DirectionUTurnLeft	7	The instruction indicates that a u-turn to the left is required.
QGeoManeuver::DirectionHardLeft	8	The instruction indicates that a hard turn to the left is required.
QGeoManeuver::DirectionLeft	9	The instruction indicates that a turn to the left is required.
QGeoManeuver::DirectionLightLeft	10	The instruction indicates that a light turn to the left is required.
QGeoManeuver::DirectionBearLeft	11	The instruction indicates that the direction of travel should bear to the left.

Member Function Documentation

QGeoManeuver::QGeoManeuver()

Constructs a invalid maneuver object.

The maneuver will remain invalid until one of setPosition(), setInstructionText(), setDirection(), setTimeToNextInstruction(), setDistanceToNextInstruction() or setWaypoint() is called.

QGeoManeuver::QGeoManeuver(const QGeoManeuver &other)

Constructs a maneuver object from the contents of other.

[protected] QGeoManeuver::QGeoManeuver(const QSharedDataPointer<QGeoManeuverPrivate> &dd)

Default constructs an instance of QGeoManeuver.

QGeoManeuver::~QGeoManeuver()

Destroys this maneuver object.

QGeoManeuver::InstructionDirection QGeoManeuver::direction() const

Returns the direction associated with the associated instruction.

See also setDirection().

qreal QGeoManeuver::distanceToNextInstruction() const

Returns the distance, in meters, between the point at which the associated instruction was issued and the point that the next instruction should be issued.

See also setDistanceToNextInstruction().

QVariantMap QGeoManeuver::extendedAttributes() const

Returns the extended attributes associated with this maneuver.

This function was introduced in QtLocation 5.11.

See also setExtendedAttributes().

QString QGeoManeuver::instructionText() const

Returns the textual navigation instructions.

See also setInstructionText().

bool QGeoManeuver::isValid() const

Returns whether this maneuver is valid or not.

Invalid maneuvers are used when there is no information that needs to be attached to the endpoint of a QGeoRouteSegment instance.

QGeoCoordinate QGeoManeuver::position() const

Returns the position where instructionText() should be displayed.

See also setPosition().

void QGeoManeuver::setDirection(QGeoManeuver::InstructionDirection direction)

Sets the direction associated with the associated instruction to direction.

See also direction().

void QGeoManeuver::setDistanceToNextInstruction(qreal distance)

Sets the distance, in meters, between the point at which the associated instruction was issued and the point that the next instruction should be issued to distance.

See also distanceToNextInstruction().

void QGeoManeuver::setExtendedAttributes(const QVariantMap &extendedAttributes)

Sets the extended attributes extendedAttributes associated with this maneuver.

This function was introduced in QtLocation 5.11.

See also extendedAttributes().

void QGeoManeuver::setInstructionText(const QString &instructionText)

Sets the textual navigation instructions to instructionText.

See also instructionText().

void QGeoManeuver::setPosition(const QGeoCoordinate &position)

Sets the position where instructionText() should be displayed to position.

See also position().

void QGeoManeuver::setTimeToNextInstruction(int secs)

Sets the estimated time it will take to travel from the point at which the associated instruction was issued and the point that the next instruction should be issued, in seconds, to secs.

See also timeToNextInstruction().

void QGeoManeuver::setWaypoint(const QGeoCoordinate &coordinate)

Sets the waypoint associated with this maneuver to coordinate.

See also waypoint().

int QGeoManeuver::timeToNextInstruction() const

Returns the estimated time it will take to travel from the point at which the associated instruction was issued and the point that the next instruction should be issued, in seconds.

See also setTimeToNextInstruction().

QGeoCoordinate QGeoManeuver::waypoint() const

Returns the waypoint associated with this maneuver.

If there is not waypoint associated with this maneuver an invalid QGeoCoordinate will be returned.

See also setWaypoint().

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

Returns whether this maneuver is not equal to other.

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

Assigns other to this maneuver object and then returns a reference to this maneuver object.

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

Returns whether this maneuver is equal to other.