Qt Location

Das Modul Qt Location hilft Ihnen bei der Erstellung von Mapping-Lösungen unter Verwendung von Daten, die von beliebten Location Service Providern, wie z.B. Open Street Map, zur Verfügung gestellt werden.

Mit der Qt Location API können Sie:

• Zugriff und Darstellung von Kartendaten.
• Unterstützung von Berührungsgesten in einem bestimmten Bereich der Karte.
• Abfrage eines bestimmten geografischen Ortes und einer bestimmten Route.
• Hinzufügen zusätzlicher Ebenen, wie z.B. Polylinien und Kreise.
• Suche nach Orten und zugehörigen Bildern.

Verwendung des Moduls

QML-API

Um die Typen zu verwenden, fügen Sie die folgenden Importanweisungen in Ihre .qml Datei ein:

import QtPositioning
import QtLocation

C++-API

Für C++-Projekte fügen Sie den Header ein, der für den aktuellen Anwendungsfall geeignet ist; zum Beispiel können Anwendungen, die Routen verwenden, diese verwenden:

#include <QGeoRoute>

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 Location)
target_link_libraries(mytarget PRIVATE Qt6::Location)

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 += location

Submodules

Die API ist in Untermodule aufgeteilt, die QML- und C++-Schnittstellen für bestimmte Zwecke bereitstellen. Sie konzentrieren sich hauptsächlich auf Karten- und Ortsinformationen. Die benötigten Positionsdaten können mit dem Modul QtPositioning abgerufen werden.

Orte

Das Places-Submodul ist die natürliche Ergänzung zu Positioning und stellt eine Quelle für geografische Daten über Places of Interest (POI) bereit. Neben den Quelleninformationen liefert die API Informationen über den Standort, die Größe und andere zugehörige Informationen zu einem POI. Die Places-API kann auch Bilder, Bewertungen und andere Inhalte zu einem Ort abrufen.

Karten und Navigation

Das Modul bietet die QML- und C++-Alternativen für Karten und Navigation. Die C++-Alternative bietet Dienstleistungsklassen zum Abrufen von Geokodierungs- (Ermittlung einer geografischen Koordinate aus einer Straßenadresse) und Navigationsinformationen (einschließlich Fahr- und Gehanweisungen), während das QML-Gegenstück UI-Komponenten zur Darstellung der Informationen bereitstellt.

Beispiele

API-Referenz

Im Folgenden finden Sie eine Liste der Klassen und UI-Komponenten, die vom Modul bereitgestellt werden, mit Beispielanwendungen, die ihre Verwendung demonstrieren:

Plugin-Referenzen und Parameter

Informationen über Plugins, wichtige Hinweise zu ihrer Verwendung, Parameter, die angegeben werden können, um ihr Verhalten zu beeinflussen.

Implementierung neuer Back-Ends und Portierung

Für Systemintegratoren und Distributoren, Informationen zur Bereitstellung von Qt Location für eine neue Plattform.

Lizenzen

Qt Location ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU Lesser General Public License, Version 3, oder der GNU General Public License, Version 2, erhältlich. Weitere Einzelheiten finden Sie unter Qt-Lizenzierung.