Location QML Type
The Location type holds location data. More...
| Import Statement: | import QtPositioning 6.2 |
| Since: | Qt 5.2 |
Properties
- address : Address
- boundingShape : geoshape
- coordinate : coordinate
- location : QGeoLocation
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.
Note: This property's changed() signal is currently emitted only if the whole object changes, not if only the contents of the object change.
Note: 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.
Note: 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".
Note: This property updates the whole geo location information, so using it will result in breaking of all the bindings for all other properties.