Sur cette page

Location QML Type

Le type « Emplacement » contient des données de localisation. En savoir plus...

Import Statement: import QtPositioning

Propriétés

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.