Qt Location

Das Modul „ Qt Location “ unterstützt Sie bei der Erstellung von Kartierungslösungen unter Verwendung von Daten, die von gängigen Anbietern von Standortdiensten wie OpenStreetMap bereitgestellt werden.

Mit der „ Qt Location “-API können Sie:

• auf Kartendaten zuzugreifen und diese darzustellen.
• Touch-Gesten in einem bestimmten Bereich der Karte zu unterstützen.
• Abfragen nach einem bestimmten geografischen Standort und einer Route.
• Hinzufügen zusätzlicher Ebenen, wie z. B. Polylinien und Kreise.
• Nach Orten und zugehörigen Bildern zu suchen.

Verwendung des Moduls

QML-API

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

import QtPositioning
import QtLocation

C++-API

Für C++-Projekte müssen Sie den für den jeweiligen Anwendungsfall geeigneten Header einbinden; Anwendungen, die Routen verwenden, können beispielsweise Folgendes nutzen:

#include <QGeoRoute>

Die Verwendung der C++-API eines Qt-Moduls erfordert die 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.

Erstellen 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 Details finden Sie in der Übersicht „Erstellen mit CMake “.

Erstellen mit qmake

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

QT += location

Submodule

Die API ist in Submodule unterteilt, die QML- und C++-Schnittstellen für bestimmte Zwecke bereitstellen. Sie konzentrieren sich hauptsächlich auf Karten- und Ortsinformationen. Die erforderlichen Positionsdaten können mithilfe des Moduls „ QtPositioning “ abgerufen werden.

Orte

Das Submodul „Places“ ist die natürliche Ergänzung zu „Positioning“ und stellt geografische Daten zu Sehenswürdigkeiten (POIs) bereit. Neben den Quellenangaben liefert die API Informationen zum Standort, zur Größe und zu weiteren relevanten Details eines POIs. Die Places-API kann zudem Bilder, Bewertungen und andere Inhalte zu einem Ort abrufen.

Karten und Navigation

Das Modul bietet QML- und C++-Alternativen für Karten und Navigation. Die C++-Alternative stellt Hilfsklassen bereit, um Geokodierungsdaten (Ermittlung geografischer Koordinaten anhand einer Straßenadresse) und Navigationsinformationen (einschließlich Routen für den Auto- und Fußweg) abzurufen, während das QML-Pendant UI-Komponenten zur Darstellung dieser Informationen bereitstellt.

Beispiele

API-Referenz

Im Folgenden finden Sie eine Auflistung der vom Modul bereitgestellten Klassen und UI-Komponenten sowie Beispielanwendungen zur Veranschaulichung ihrer Verwendung:

Plugin-Referenzen und Parameter

Informationen zu Plugins, wichtige Hinweise zu ihrer Verwendung sowie Parameter, die zur Steuerung ihres Verhaltens übergeben werden können.

Implementierung neuer Backends und Portierung

Für Systemintegratoren und Vertriebspartner: 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 steht es unter der GNU Lesser General Public License, Version 3, oder der GNU General Public License, Version 2, zur Verfügung. Weitere Informationen finden Sie unter Qt-Lizenzierung.