Waypoint QML Type
The Waypoint type provides a mean to specify a waypoint in a RouteQuery in a more detailed way than by using a simple coordinate. More...
| Import Statement: | import QtLocation 5.15 |
| Since: | QtLocation 5.11 |
Properties
- altitude : real
- bearing : real
- coordinate : coordinate
- latitude : real
- longitude : real
- metadata : VariantMap
Detailed Description
A Waypoint is a type that allows to specify properties of a waypoint in a RouteQuery, such as the waypoint coordinate, or the angle of approach to the waypoint.
Additional information that are backend-specific can be specified by nesting MapParameter elements.
Changing properties of the waypoint or of its nested MapParameteters will cause the containing RouteQuery to emit the queryDetailsChanged signal.
Example Usage
Plugin {
id: aPlugin
name: "osm"
}
Waypoint {
id: waypointStart
coordinate: ...
bearing: ...
}
Waypoint {
id: waypointFinish
coordinate: ...
bearing: ...
}
RouteQuery {
id: aQuery
Component.onCompleted: {
travelModes = RouteQuery.CarTravel
addWaypoint(waypointStart)
var aWaypoint = Qt.createQmlObject ('import QtLocation 5.11; Waypoint { ... }', ...)
addWaypoint(aWaypoint)
addWaypoint(waypointFinish)
}
}
RouteModel {
id: routeModel
plugin: aPlugin
query: aQuery
autoUpdate: true
}
See also RouteQuery.
Property Documentation
The altitude of the waypoint's coordinate. The default value is NaN. Changing this property will affect the Waypoint::coordinate property as well.
The bearing specifying the angle of approach of the waypoint, that is the bearing with which the waypoint is to be approached. This information may be used by the provider to filter the road segment the waypoint will be placed on, and, depending on the provider and the travel mode used, to restrict the maneuvers allowed at the waypoint, potentially making the provider calculating and returning a different route.
If set to NaN, this value will not be considered.
The default value is NaN.
The latitude of the waypoint's coordinate. The default value is NaN. Changing this property will affect the Waypoint::coordinate property as well.
The longitude of the waypoint's coordinate. The default value is NaN. Changing this property will affect the Waypoint::coordinate property as well.
The waypoint metadata. This property is read only. If the waypoint is defined by the user, these can be set by using MapParameters. If the waypoint comes from the engine via signals, or as part of a read-only route query, the waypoint is intended to be read-only.