Qt Positioning

L'API Qt Positioning fournit des informations de positionnement via des interfaces QML et C++.

Actuellement, l'API est prise en charge sur Android, iOS, macOS, Linux et Windows (avec des récepteurs GPS exposés en tant que port série fournissant des phrases NMEA ou utilisant Windows.Devices.Geolocation).

Vue d'ensemble

L'API Qt Positioning vous permet de déterminer une position en utilisant une variété de sources possibles, y compris les satellites, le wifi ou les fichiers texte. Ces informations peuvent ensuite être utilisées pour, par exemple, déterminer une position sur une carte. En outre, vous pouvez utiliser l'API pour récupérer des informations satellitaires et effectuer une surveillance basée sur la zone.

Utilisation du module

API QML

Les types QML du module sont disponibles via l'importation QtPositioning. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :

import QtPositioning

API C++

L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:

find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Construction avec qmake

Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += positioning

Permissions

À partir de Qt 6.6, le module Qt Positioning utilise la nouvelle API QPermission pour gérer les permissions location. Cela signifie que Qt lui-même ne demande plus ces permissions, ce qui doit être fait directement à partir de l'application cliente.

Veuillez vous référer à la page Permissions de l'application pour un exemple d'intégration de la nouvelle API QPermission dans l'application.

Articles et guides

• Introduction au positionnement en C++
• Introduction au positionnement en QML
• Qt Positioning Plugins
• Interfaces entre le code C++ et le code QML dans Qt Positioning
• Qt Positioning sur Android
• Qt Positioning sur iOS

Exemples d'application

• Qt Positioning Exemples

Référence

• Qt Positioning C++ Classes
• Qt Positioning QML Types

Évolution des modules

Changes to Qt Positioning liste les changements importants dans l'API et les fonctionnalités du module qui ont été effectués pour la série Qt 6 de Qt.

Licences

Qt Positioning est disponible sous les licences commerciales de The Qt Company. En outre, il est disponible sous des licences de logiciel libre. Depuis Qt 5.4, ces licences de logiciel libre sont la GNU Lesser General Public License, version 3, ou la GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.