Location QML Type▲
-
Import Statement: import QtPositioning 6.4
-
Since:: Qt 5.2
Detailed Description▲
Location types represent a geographic "location", in a human sense. This consists of a specific coordinate, an address and a bounding shape. The bounding shape represents the recommended region to display when viewing this location.
The Location type is most commonly seen as the contents of a search model such as the GeocodeModel. When a GeocodeModel returns the list of locations found for a given query, it represents these as Location objects.
Example Usage▲
The following example shows a simple Location object being declared:
Location {
coordinate {
latitude: -27.3
longitude: 153.1
}
address: Address {
...
}
}Property Documentation▲
address : Address▲
This property holds the address of the location which can be use to retrieve address details of the location.
[since QtPositioning 6.2] boundingShape : geoshape▲
This property holds the recommended region to use when displaying the location. For example, a building's location may have a region centered around the building, but the region is large enough to show it's immediate surrounding geographical context.
This property's changed() signal is currently emitted only if the whole object changes, not if only the contents of the object change.
This property was introduced in Qt6 instead of boundingBox property. It returns a geoshape instead of a georectangle. Use QGeoShape::boundingGeoRectangle() to obtain a bounding georectangle for the shape.
If you need to convert the returned shape to a specific type, use the type property of geoshape together with convenience methods from QtPositioning like QtPositioning.shapeToRectangle().
This property was introduced in QtPositioning 6.2.
coordinate : coordinate▲
This property holds the exact geographical coordinate of the location which can be used to retrieve the latitude, longitude and altitude of the location.
this property's changed() signal is currently emitted only if the whole object changes, not if only the contents of the object change.
location : QGeoLocation▲
For details on how to use this property to interface between C++ and QML see "Interfaces between C++ and QML Code".
This property updates the whole geo location information, so using it will result in breaking of all the bindings for all other properties.