Navigator QML Type
The Navigator type offers functionalities to perform turn-by-turn navigation. More...
|import Qt.labs.location 1.0
- active : bool
- automaticReroutingEnabled : bool
- directions.alternativeRoutes : model
- directions.currentRoute : Route
- directions.currentRouteLeg : RouteLeg
- directions.currentSegment : int
- directions.distanceToNextManeuver : real
- directions.nextManeuverIcon : Variant
- directions.remainingTravelDistance : real
- directions.remainingTravelDistanceToNextWaypoint : real
- directions.remainingTravelTime : int
- directions.remainingTravelTimeToNextWaypoint : int
- directions.timeToNextManeuver : int
- directions.traveledDistance : real
- directions.traveledTime : int
- error : enumeration
- isOnRoute : bool
- map : Map
- navigatorReady : bool
- plugin : Plugin
- positionSource : PositionSource
- route : Route
- trackPositionSource : bool
- void recalculateRoutes()
The Navigator purpose is to use a plugin's turn-by-turn navigation implementation in a QML application in a seamless manner. This object may take control of the map position, orientation, tilting and zoom, as well as changing the map style, elements on the map such as direction information. In certain cases, it may also restrict user interaction with the Map and with the items on it.
active : bool
This property tells whether the Navigator is navigating or not. Set this property to
true to start the navigation. Set it to
false to stop an active navigation session.
automaticReroutingEnabled : bool
This property tells whether the Navigator should automatically recalculate the route when the position from positionSource ends too far from the route. The operation performed in such case is equivalent to calling recalculateRoutes. The default value is
Note: Whether this property has any effect is plugin-dependent. Also, whether or not it has an effect while the navigator is active is plugin-dependent.
[read-only] directions.currentRoute : Route
[read-only] directions.currentRouteLeg : RouteLeg
[read-only] directions.currentSegment : int
[read-only] directions.distanceToNextManeuver : real
[read-only] directions.remainingTravelDistance : real
[read-only] directions.remainingTravelDistanceToNextWaypoint : real
[read-only] directions.remainingTravelTime : int
[read-only] directions.remainingTravelTimeToNextWaypoint : int
[read-only] directions.timeToNextManeuver : int
[read-only] directions.traveledDistance : real
[read-only] directions.traveledTime : int
These read-only properties are part of the directions property group. This property group holds the navigation progress information that can be used to access the route data and to extract directions.
Note: Some backends might not provide a full set of navigation progress information.
nextManeuverIconproperty holds the next turn icon.
distanceToNextManeuverproperty holds the distance to the next maneuver, in meters.
remainingTravelDistanceproperty holds the remaining travel distance, in meters.
remainingTravelDistanceToNextWaypointproperty holds the remaining travel distance to the next waypoint, in meters.
traveledDistanceproperty holds the traveled distance, in meters.
timeToNextManeuverproperty holds the time to the next maneuver, in milliseconds.
remainingTravelTimeproperty holds the remaining travel time, in milliseconds.
remainingTravelTimeToNextWaypointproperty holds the remaining travel time to the next waypoint, in milliseconds.
traveledTimeproperty holds the traveled time, in milliseconds.
currentRouteproperty holds the current route the navigator is following. This can be the same as route, or can be different, if the navigator cannot follow the user-specified route. For example, if the position coming from positionSource is considerably off route, the navigation engine may recalculate and start to follow a new route.
currentRouteLegproperty holds the current route leg the navigator is following. This is always a part of
currentRoute, so the overallRoute property of
currentRouteLegholds the same route as
currentSegmentproperty holds the index of the current RouteSegment in the
alternativeRoutesproperty holds the list of alternative routes provided by the engine. If no alternative routes are present, the model will be empty.
[read-only] error : enumeration
This read-only property holds the latest error value of the geocoding request.
|No error has occurred.
|Navigation is not supported by the service provider.
|An error occurred while communicating with the service provider.
|The geoservice provider library could not be loaded. Setting QT_DEBUG_PLUGINS environment variable may help diagnosing the problem.
|An unknown parameter was specified.
|Required parameter was not specified.
|Unknown error occurred.
isOnRoute : bool
While the Navigator is in active tracking mode, this property tells whether the position from positionSource is on the route or not.
map : Map
This property holds the Map that the navigator is in charge of controlling.
This is a write-once property. Once the Navigator has a Map associated with it, any attempted modifications of the map property will be ignored.
See also Map.
navigatorReady : bool
This read-only property tells whether the navigator is ready to start the navigation or not. A Navigator becomes ready once the plugin is attached and a navigation engine has been instantiated, and the other required properties are set to valid values.
plugin : Plugin
This property holds the plugin which provides the navigation functionality.
This is a write-once property. Once the Navigator has a plugin associated with it, any attempted modifications of the plugin property will be ignored.
See also Plugin.
positionSource : PositionSource
This property holds the PositionSource that the navigator will receive position updates from to perform the navigation.
This is a write-once property. Once the Navigator has a PositionSource associated with it, any attempted modifications of the positionSource property will be ignored.
See also PositionSource.
route : Route
This property holds the Route that the navigator is using to perform the navigation.
Note: Setting this property while a navigation session is ongoing will stop the navigation.
See also Route.
trackPositionSource : bool
This property tells whether the Navigator should control the Map camera to keep track of position source updates. This property is enabled (
true) by default, and setting it to
false is useful in cases where e.g. the user starts gesturing over the map area.
Navigator plugins can also control this property directly e.g. user map interaction could trigger the property change. Honoring the user-specified value of this property is plugin dependent.
Calling this method forces the backend to trigger a routes recalculation.
See also automaticReroutingEnabled.
© 2023 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.