Location QML Type

The Location type holds location data. More...

Import Statement: import QtPositioning 6.2
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.

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.

© 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.