Location QML Type

Le type Location contient des données de localisation. Plus d'informations...

Import Statement: import QtPositioning

Propriétés

Description détaillée

Les types d'emplacement représentent un "emplacement" géographique, au sens humain du terme. Il se compose d'un coordinate spécifique, d'un address et d'un bounding shape. Le bounding shape représente la région qu'il est recommandé d'afficher lors de la visualisation de cet emplacement.

Le type Emplacement est le plus souvent considéré comme le contenu d'un modèle de recherche tel que GeocodeModel. Lorsqu'un GeocodeModel renvoie la liste des emplacements trouvés pour une requête donnée, il les représente sous la forme d'objets Emplacement.

Exemple d'utilisation

L'exemple suivant montre la déclaration d'un objet Location simple :

Location {
    coordinate {
        latitude: -27.3
        longitude: 153.1
    }
    address: Address {
        ...
    }
}

Propriété Documentation

address : Address

Cette propriété contient l'adresse de l'emplacement qui peut être utilisée pour récupérer les détails de l'adresse de l'emplacement.


boundingShape : geoshape [since QtPositioning 6.2]

Cette propriété contient la région recommandée pour l'affichage de l'emplacement. Par exemple, l'emplacement d'un bâtiment peut avoir une région centrée autour du bâtiment, mais la région est suffisamment grande pour montrer le contexte géographique environnant.

Note : Le signal changed() de cette propriété n'est actuellement émis que si l'objet entier change, et non si seul le contenu de l'objet change.

Note : Cette propriété a été introduite dans Qt6 à la place de la propriété boundingBox. Elle renvoie une forme géométrique au lieu d'un géorectangle. Utilisez QGeoShape::boundingGeoRectangle() pour obtenir un géorectangle de délimitation pour la forme.

Si vous devez convertir la forme renvoyée en un type spécifique, utilisez la propriété type de geoshape ainsi que les méthodes de commodité de QtPositioning comme QtPositioning.shapeToRectangle().

Cette propriété a été introduite dans QtPositioning 6.2.


coordinate : coordinate

Cette propriété contient les coordonnées géographiques exactes de l'emplacement qui peuvent être utilisées pour récupérer la latitude, la longitude et l'altitude de l'emplacement.

Remarque : le signal changed() de cette propriété n'est actuellement émis que si l'objet entier change, et non si seul le contenu de l'objet change.


location : QGeoLocation

Pour plus de détails sur la manière d'utiliser cette propriété pour établir une interface entre C++ et QML, voir"Interfaces entre le code C++ et QML".

Remarque : cette propriété met à jour l'ensemble des informations relatives à la géolocalisation, de sorte que son utilisation entraîne la rupture de toutes les liaisons pour toutes les autres propriétés.


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