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 sous forme de port série fournissant des messages NMEA ou utilisant Windows.Devices.Geolocation).

Présentation

L'API Qt Positioning vous permet de déterminer une position à l'aide de diverses sources possibles, notamment les satellites, le Wi-Fi ou des fichiers texte. Ces informations peuvent ensuite être utilisées, par exemple, pour déterminer une position sur une carte. De plus, vous pouvez utiliser l'API pour récupérer des informations satellitaires et effectuer une surveillance par zone.

Utilisation du module

API QML

Les types QML du module sont disponibles via l’importation QtPositioning. Pour utiliser ces types, ajoutez la déclaration d’importation suivante à votre fichier .qml :

import QtPositioning

API C++

L'utilisation de l'API C++ d'un module Qt nécessite une liaison avec la bibliothèque du module, soit directement, soit via d'autres dépendances. Plusieurs outils de compilation prennent cela en charge, notamment CMake et qmake.

Compilation avec CMake

Utilisez la commande ` find_package() ` pour localiser le composant du module requis dans le paquet ` Qt6 ` :

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

Pour plus de détails, consultez la présentation « Compilation avec CMake ».

Compilation avec qmake

Pour configurer le module en vue d’une compilation avec qmake, ajoutez le module en tant que valeur de la variable QT dans le fichier .pro du projet :

QT += positioning

Autorisations

À partir de Qt 6.6, le module Qt Positioning utilise la nouvelle API QPermission pour gérer les autorisations d’ location. Cela signifie que Qt ne demande plus ces autorisations lui-même ; cette opération doit donc être effectuée directement depuis l’application cliente.

Veuillez vous reporter à la page Autorisations de l'application pour découvrir un exemple d’intégration de la nouvelle API QPermission dans l’application.

Articles et guides

• Introduction au positionnement en C++
• Introduction au positionnement pour QML
• Qt Positioning Plug-ins
• Interfaces entre le code C++ et QML sous Qt Positioning
• Qt Positioning sur Android
• Qt Positioning sur iOS
• Qt Positioning Considérations relatives à la sécurité

Exemples

• Qt Positioning Exemples

Référence

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

Évolution du module

La section «Modifications apportées à l’ Qt Positioning » répertorie les modifications importantes apportées à l’API et aux fonctionnalités du module dans le cadre de la série Qt 6 de Qt.

Licences

Qt Positioning est disponible sous des licences commerciales auprès de The Qt Company. Il est également disponible sous des licences de logiciels libres. Depuis Qt 5.4, ces licences de logiciels libres sont la Licence publique générale restreinte GNU, version 3, ou la Licence publique générale GNU, version 2. Voir Licences Qt pour plus de détails.