Location QML Type
Le type Location contient des données de localisation. Plus d'informations...
| Import Statement: | import QtPositioning |
Propriétés
- address : Address
- boundingShape : geoShape
(since QtPositioning 6.2) - coordinate : coordinate
- extendedAttributes : VariantMap
- location : QGeoLocation
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.
Remarque : cette propriété a été introduite dans Qt6 à la place de la propriété boundingBox. Elle renvoie un geoShape au lieu d'un geoRectangle. Utilisez QGeoShape::boundingGeoRectangle() pour obtenir un bounding geoRectangle 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.
extendedAttributes : VariantMap
Cette propriété contient les attributs étendus de cet emplacement. Les attributs étendus dépendent du backend et peuvent dépendre de l'emplacement.
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".
Note : 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.
© 2026 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.