Liste des lieux (QML)

Exécution de l'exemple

Vous pouvez exécuter l'exemple à partir de :

• Qt Creator

  Ouvrez le mode « Welcome » et sélectionnez l’exemple à l’adresse Examples. Pour plus d’informations, consultez Qt Creator: Tutoriel : Compiler et exécuter.

• Qt Extension for Visual Studio Code

  Exécutez la commande « Qt: Open Qt examples » à partir de Command Palette, puis sélectionnez l’exemple dans la liste. Pour plus d’informations, consultez Qt Extension for Visual Studio Code: Tutoriel : Compiler et exécuter.

L’exemple « Places List » montre comment rechercher une liste de lieux dans une zone donnée et affiche le résultat à l’aide d’un ListView. Dans ce cas précis, une recherche est effectuée pour trouver les lieux associés au terme « food ».

Effectuer une recherche de lieux

Pour écrire une application QML qui affichera des lieux sous forme de liste, nous commençons par définir les déclarations d’importation suivantes.

import QtQuick
import QtPositioning
import QtLocation

Instancier une instance de ` Plugin `. Le ` Plugin ` correspond en fait au backend à partir duquel les lieux sont récupérés. Selon le type de plugin, certains paramètres obligatoires peuvent devoir être renseignés. Les ` PluginParameter ` sont le plus souvent des jetons d’accès au service, dont la documentation figure dans le plugin de service. Dans cet extrait de code, le plugin ` osm ` est utilisé ; il ne nécessite aucun paramètre supplémentaire :

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

Ensuite, nous instancions un ` PlaceSearchModel `, que nous pouvons utiliser pour spécifier des paramètres de recherche et effectuer une opération de recherche de lieux. À titre d’illustration, la méthode ` update()` est appelée une fois la construction du modèle terminée. En général, la méthode ` update()` serait appelée 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 ` ListView ` pour afficher les résultats de 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 ` type ` ou ` PlaceSearchesult`. Par conséquent, nous partons du principe que nous avons toujours accès au ` place ` ` role` ; d’autres types de résultats de recherche peuvent ne pas disposer d’un `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