Liste des lieux (QML)

Exécution de l'exemple

Pour exécuter l'exemple à partir de Qt Creatorouvrez le mode Welcome et sélectionnez l'exemple à partir de Examples. Pour plus d'informations, voir Qt Creator: Tutoriel : Construire et exécuter.

L'exemple Places List montre comment rechercher une liste de lieux dans une certaine zone et affiche le résultat à l'aide d'un ListView. Dans ce cas particulier, une recherche de lieux associés au terme food est effectuée.

Effectuer une recherche de lieux

Pour écrire une application QML qui affichera des lieux dans une liste, nous commençons par faire les déclarations d'importation suivantes.

import QtQuick
import QtPositioning
import QtLocation

Instanciation d'une instance de Plugin. L'instance Plugin est en fait le backend d'où proviennent les lieux. Selon le type de plugin, certains paramètres obligatoires peuvent devoir être remplis. Le type le plus probable de PluginParameter est une forme de jeton d'accès au service qui est documenté dans le plugin de service. Dans cet extrait, nous utilisons le plugin osm qui ne nécessite aucun autre paramètre :

Plugin {
    id: myPlugin
    name: "osm"
    //specify plugin parameters as necessary
    //PluginParameter {...}
    //PluginParameter {...}
    //...
}

Ensuite, nous instançons un PlaceSearchModel que nous pouvons utiliser pour spécifier des paramètres de recherche et effectuer une opération de recherche de lieux. À des fins d'illustration, update() est invoqué une fois la construction du modèle terminée. En règle générale, update() est invoqué en réponse à une action de l'utilisateur telle qu'un clic sur un bouton.

PlaceSearchModel {
    id: searchModel

    plugin: myPlugin

    searchTerm: "food"
    searchArea: QtPositioning.circle(startCoordinate, 5000 /* 5 km radius */);

    Component.onCompleted: update()

}

Enfin, nous instancions un site ListView pour afficher les résultats de la recherche trouvés par le modèle. Un délégué en ligne a été utilisé et nous avons supposé que chaque résultat de recherche est de type PlaceSearchesult . Par conséquent, nous supposons que nous avons toujours accès à la place role, d'autres types de résultats de recherche peuvent ne pas avoir de place role.

ListView {
    anchors.fill: parent
    model: searchModel
    delegate: Component {
        Row {
            spacing: 5
            Marker { height: parent.height }
            Column {
                Text { text: title; font.bold: true }
                Text { text: place.location.address.text }
            }
        }
    }
}

Exemple de projet @ code.qt.io