Cartes et navigation (QML)

La section «Cartes et navigation » fournit des types d’interface utilisateur QtQuick permettant d’afficher des informations géographiques sur une carte, ainsi que d’interagir avec les objets superposés à la carte et l’affichage lui-même. Elle contient également des utilitaires 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).

Pour effectuer une navigation, nous avons besoin d’ routes entre le point de départ et la destination. Ces itinéraires sont constitués de segments, où chaque routeSegment peut être considérée comme une sous-tâche de navigation ; par exemple, « rouler 100 mètres » ou « tourner à gauche ». Le début et la fin de chaque segment constituent un point de passage, c’est-à-dire une partie du trajet.

Un cas d’utilisation typique de l’API est celui d’un utilisateur recherchant un type de lieu particulier, tel qu’un restaurant ; l’utilisateur saisit une chaîne de recherche dans l’application cartographique et se voit proposer une liste de résultats pour les restaurants « à proximité » de l’appareil. L'application peut ensuite être utilisée pour se rendre à la destination choisie en suivant un itinéraire optimisé en fonction des caractéristiques de l'environnement susceptibles de faciliter ou de compliquer le trajet. La navigation se poursuit alors, la progression de l'utilisateur étant suivie grâce à sa position actuelle.

Ces types s’appuient sur les concepts et les types de l’API de positionnement QML. Une introduction plus pratique aux types « Maps » et « Navigation » est disponible dans le tutoriel « Maps and Navigation ».

Cartes

Affichage des cartes

L’affichage d’une carte s’effectue à l’aide des types QML de l’API « Map ». Le type « Map » prend en charge l’interaction avec l’utilisateur via le type QML « MapView ». L’objet « Map » dessine la carte à l’écran à l’aide d’OpenGL (ES), ce qui permet un rendu accéléré par le matériel lorsque cela est possible.

Types clés

Notez que le client doit créer un objet « Plugin » avant d’utiliser un type « Map » afin d’avoir accès aux données cartographiques à afficher.

Placer des objets sur une carte (objets de superposition de carte)

Les cartes peuvent également contenir des objets de superposition, qui servent à afficher des informations à la surface de la carte. Il existe un ensemble d’objets de superposition prédéfinis de base, ainsi que la possibilité d’implémenter des objets de superposition personnalisés à l’aide du type ` MapQuickItem `, qui peut contenir n’importe quel élément standard de type ` QtQuick `.

Principaux types

Conception modèle-vue avec des objets de superposition cartographique

Pour générer automatiquement des objets de superposition de carte à partir du contenu d’un modèle « QtQuick » (par exemple, un élément « ListModel »), le type « MapItemView » est disponible. Il accepte n’importe quel objet de superposition de carte comme délégué et ne peut être créé qu’au sein d’un « Map ».

Types de clés

Interaction avec les objets de superposition cartographique

Les propriétés des objets de superposition cartographique qui influencent leur apparence à l’écran peuvent être modifiées à tout moment, et nombre d’entre elles peuvent également être utilisées dans des animations. L’animation d’objets de superposition cartographique basés sur des coordonnées, tels que les objets « MapPolygon » et « MapPolyline », n’est pas encore disponible.

Géocodage – De l’adresse aux coordonnées et inversement

Le géocodage consiste à convertir des coordonnées géographiques en adresses, ou inversement. Une telle conversion implique généralement l’envoi des données sources à un serveur qui effectue ensuite la conversion et renvoie les résultats, bien que certains fournisseurs de services de localisation plugins puissent être en mesure de proposer certaines fonctionnalités de géocodage sans envoyer de données à un serveur distant. La disponibilité et la précision de la conversion dépendent généralement de l’emplacement ou de l’adresse à convertir, car les différentes régions de la Terre sont cartographiées avec des degrés de précision variables.

Une requête de géocodage en QML s’effectue à l’aide du type ` GeocodeModel `. Pour une requête d’adresse vers des coordonnées, sa propriété ` query ` peut être définie soit sur un objet ` Address `, soit sur une chaîne de caractères contenant la forme textuelle de l’adresse à rechercher. Pour effectuer l’opération inverse, cette même propriété peut être définie sur un objet ` geoCoordinate `. Les résultats sont disponibles dans le contenu du modèle.

Types de clés

Notez que le client doit créer un objet ` Plugin ` avant d'utiliser un objet ` GeocodeModel `. Cela permettra d'accéder aux services de géocodage et donc aux données à afficher.

Itinéraires et navigation

Le calcul d’itinéraire consiste à déterminer un parcours praticable d’un point à un autre sur une carte. À partir d’une carte tenant compte des éléments facilitant ou entravant la navigation, tels que les ponts, les cours d’eau, etc., il est possible de construire une série de segments constituant l’itinéraire. Si ces segments d’itinéraire ( routeSegments) sont simples, il est alors possible d’ajouter des informations de navigation aux points de jonction, appelés nœuds de géocodage ( routeManeuvers), entre les segments.

Types de clés