Qt Location

Le module « Qt Location » vous aide à créer des solutions cartographiques à partir des données fournies par les principaux fournisseurs de services de localisation, tels qu’OpenStreetMap.

L'API « Qt Location » vous permet de :

• d'accéder aux données cartographiques et de les afficher ;
• Prendre en charge les gestes tactiles sur une zone spécifique de la carte.
• Rechercher un lieu géographique et un itinéraire spécifiques.
• Ajouter des couches supplémentaires, telles que des polylignes et des cercles.
• Rechercher des lieux et des images associées.

Utilisation du module

API QML

Pour utiliser ces types, ajoutez les instructions d'importation suivantes à votre fichier ` .qml ` :

import QtPositioning
import QtLocation

API C++

Pour les projets C++, incluez l'en-tête adapté au cas d'utilisation actuel ; par exemple, les applications utilisant des itinéraires peuvent utiliser :

#include <QGeoRoute>

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

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

Sous-modules

L’API est divisée en sous-modules, qui fournissent des interfaces QML et C++ à des fins spécifiques. Ils se concentrent principalement sur les informations relatives aux cartes et aux lieux. Les données de position requises peuvent être récupérées à l’aide du module ` QtPositioning `.

Lieux

Le sous-module « Places » est le complément naturel du module « Positioning » : il fournit une source de données géographiques sur les lieux d’intérêt (POI). Outre les informations de provenance, l’API fournit des renseignements sur l’emplacement, la taille et d’autres détails relatifs à un POI. L’API « Places » permet également de récupérer des images, des avis et d’autres contenus liés à un lieu.

Cartes et navigation

Ce module propose des alternatives en QML et en C++ pour les cartes et la navigation. L’alternative en C++ fournit des classes utilitaires permettant d’obtenir des informations de géocodage (recherche de coordonnées géographiques à partir d’une adresse postale) et de navigation (notamment des itinéraires en voiture et à pied), tandis que son équivalent en QML fournit des composants d’interface utilisateur pour afficher ces informations.

Exemples

Référence de l'API

Vous trouverez ci-dessous la liste des classes et des composants d'interface utilisateur fournis par le module, accompagnés d'exemples d'applications illustrant leur utilisation :

Références et paramètres des plugins

Informations sur les plugins, remarques importantes concernant leur utilisation, paramètres pouvant être fournis pour influencer leur comportement.

Implémentation de nouveaux back-ends et portage

À l'intention des intégrateurs de systèmes et des distributeurs, informations relatives à la mise à disposition d'Qt Location s pour une nouvelle plateforme.

Licences

Qt Location est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence GNU Lesser General Public License, version 3, ou GNU General Public License, version 2. Pour plus d'informations, consultez la page Licences Qt.