Navigator QML Type
The Navigator type offers functionalities to perform turn-by-turn navigation. More...
Import Statement: | import Qt.labs.location 1.0 |
Properties
- active : bool
- currentRoute : Route
- currentSegment : int
- map : Map
- navigatorReady : bool
- plugin : Plugin
- positionSource : PositionSource
- route : Route
- trackPositionSource : bool
Signals
- destinationReached()
- waypointReached(Waypoint waypoint)
Detailed Description
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.
Property Documentation
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.
currentRoute : Route |
This read-only property holds the current route the navigator 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 might recalculate and start following a new route.
See also Route.
currentSegment : int |
This read-only property holds the index of the current RouteSegment in the currentRoute.
See also RouteSegment.
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 supposed to use to perform the navigation.
Note: This property is not necessarily the same as currentRoute. currentRoute may differ, during routing, for various reasons. It is reasonable to assume, however, that currentRoute's destination will be the same as route's destination. 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.
Signal Documentation
This signal is emitted when the last waypoint of the route, the destination, has been reached.
waypointReached(Waypoint waypoint) |
This signal is emitted when the waypoint waypoint has been reached.
See also Waypoint.
© 2021 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.