Qt Location

Le module Qt Location vous aide à créer des solutions cartographiques en utilisant les données disponibles auprès des fournisseurs de services de localisation les plus populaires, tels que Open Street Map.

L'API Qt Location vous permet de

• d'accéder aux données cartographiques et de les présenter
• Prendre en charge les gestes tactiles sur une zone spécifique de la carte.
• Rechercher un emplacement 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 connexes.

Utilisation du module

API QML

Pour utiliser les 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 approprié au cas d'utilisation actuel ; par exemple, les applications utilisant des routes peuvent utiliser :

#include <QGeoRoute>

L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par le biais d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:

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

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Construction avec qmake

Pour configurer le module en vue de sa construction 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 à la carte et au lieu. Les données de position requises peuvent être récupérées à l'aide du module QtPositioning.

Lieux

Le sous-module Lieux est le complément naturel du module Positionnement. Il fournit une source de données géographiques sur les lieux d'intérêt (POI). Outre les informations sur la source, l'API fournit des informations sur l'emplacement, la taille et d'autres informations connexes sur un POI. L'API Lieux peut également récupérer des images, des commentaires et d'autres contenus relatifs à un lieu.

Cartes et navigation

Le module fournit les alternatives QML et C++ pour les cartes et la navigation. L'alternative C++ fournit des classes utilitaires pour obtenir des informations de géocodage (trouver une coordonnée géographique à partir d'une adresse) et de navigation (y compris des indications pour conduire et marcher), tandis que son équivalent QML fournit des composants d'interface utilisateur pour rendre l'information.

Exemples de cartes et de navigation

Référence API

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

Références et paramètres des plugins

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

Mise en œuvre de nouveaux back-end et portage

Pour les intégrateurs de systèmes et les distributeurs, informations relatives à la mise à disposition de Qt Location pour une nouvelle plate-forme.

Licences

Qt Location est disponible sous les licences commerciales de The Qt Company. En outre, elle est disponible sous la Licence Publique Générale Amoindrie de GNU, version 3, ou la Licence Publique Générale de GNU, version 2. Voir Qt Licensing pour plus de détails.