Location QML Type
Le type « Emplacement » contient des données de localisation. En savoir plus...
| 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 de localisation représentent une « localisation » géographique, au sens où l'entend l'être humain. Ils se composent d'une coordinate spécifique, d'une address et d'une bounding shape. La bounding shape représente la région recommandée à afficher lors de la visualisation de cette localisation.
Le type « Emplacement » est le plus souvent utilisé comme contenu d’un modèle de recherche, tel que l’ GeocodeModel. Lorsqu’un GeocodeModel renvoie la liste des emplacements trouvés pour une requête donnée, il les représente sous 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 {
...
}
}Documentation des propriétés
address : Address
Cette propriété contient l'adresse du lieu ; elle peut être utilisée pour récupérer les détails de cette adresse.
boundingShape : geoShape [since QtPositioning 6.2]
Cette propriété contient la région recommandée à utiliser lors de l'affichage de la localisation. Par exemple, la localisation d'un bâtiment peut correspondre à une région centrée sur celui-ci, mais suffisamment étendue pour montrer son contexte géographique immédiat.
Remarque : cette propriété a été introduite dans Qt6 en remplacement de la propriété `boundingBox`. Elle renvoie un objet de type ` geoShape ` au lieu d’un objet de type ` geoRectangle`. Utilisez la méthode ` QGeoShape::boundingGeoRectangle()` pour obtenir un `bounding geoRectangle ` correspondant à la forme.
Si vous devez convertir la forme renvoyée en un type spécifique, utilisez la propriété ` type ` de ` geoShape ` avec les méthodes pratiques de ` QtPositioning `, telles que ` QtPositioning.shapeToRectangle()`.
Cette propriété a été introduite dans QtPositioning 6.2.
coordinate : coordinate
Cette propriété contient les coordonnées géographiques exactes du lieu ; elles permettent d'obtenir la latitude, la longitude et l'altitude de ce lieu.
extendedAttributes : VariantMap
Cette propriété contient les attributs étendus associés à cet emplacement. Les attributs étendus dépendent du backend et peuvent varier en fonction de l'emplacement.
location : QGeoLocation
Pour plus de détails sur l'utilisation de cette propriété afin d'assurer l'interfaçage entre le C++ et le QML, consultez la section «Interfaces entre le code C++ et le code QML ».
Remarque : cette propriété met à jour l'ensemble des informations de géolocalisation ; son utilisation entraînera donc la rupture de tous 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.