Qt Positioning

Die Qt Positioning API bietet Positionsdaten über QML- und C++-Schnittstellen.

Derzeit wird die API von Android, iOS, macOS, Linux und Windows unterstützt (mit GPS-Empfängern, die als serielle Schnittstelle NMEA-Sätze liefern oder Windows.Devices.Geolocation verwenden).

Überblick

Mit der Qt Positioning API können Sie eine Position aus einer Vielzahl möglicher Quellen bestimmen, darunter Satelliten, WLAN oder Textdateien. Diese Informationen können dann z. B. zur Bestimmung einer Position auf einer Karte verwendet werden. Darüber hinaus können Sie mit der API Satelliteninformationen abrufen und eine gebietsbezogene Überwachung durchführen.

Verwendung des Moduls

QML-API

Die QML-Typen des Moduls sind über den QtPositioning -Import verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Import-Anweisung in Ihre .qml-Datei ein:

import QtPositioning

C++-API

Die Verwendung der C++-API eines Qt-Moduls erfordert eine Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Bauen mit CMake

Verwenden Sie den Befehl find_package(), um die benötigte Modulkomponente im Paket Qt6 zu finden:

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

Weitere Einzelheiten finden Sie in der Übersicht Bauen mit CMake.

Bauen mit qmake

Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variable QT in der .pro-Datei des Projekts hinzu:

QT += positioning

Permissions

Ab Qt 6.6 verwendet das Qt Positioning Modul die neue QPermission API, um location Berechtigungen zu handhaben. Das bedeutet, dass Qt selbst nicht mehr nach diesen Berechtigungen fragt, so dass dies direkt von der Client-Anwendung aus geschehen muss.

Auf der Seite Anwendungsberechtigungen finden Sie ein Beispiel für die Integration der neuen QPermission API in die Anwendung.

Artikel und Leitfäden

• Einführung in die Positionierung für C++
• Einführung in die Positionierung für QML
• Qt Positioning Plugins
• Schnittstellen zwischen C++ und QML Code in Qt Positioning
• Qt Positioning unter Android
• Qt Positioning unter iOS

Beispiele

• Qt Positioning Beispiele

Referenz

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

Modul-Entwicklung

Änderungen an Qt Positioning listet wichtige Änderungen an der Modul-API und Funktionalität auf, die für die Qt 6-Serie von Qt vorgenommen wurden.

Lizenzen

Qt Positioning ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Software-Lizenzen verfügbar. Seit Qt 5.4 sind diese Lizenzen für freie Software die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Siehe Qt-Lizenzierung für weitere Details.