Lista de lugares (QML)

Ejecución del ejemplo

Para ejecutar el ejemplo desde Qt Creatorabra el modo Welcome y seleccione el ejemplo de Examples. Para más información, consulte Qt Creator: Tutorial: Construir y ejecutar.

El ejemplo Places List demuestra cómo buscar una lista de lugares en una zona determinada y muestra el resultado utilizando un ListView. En este caso concreto, se realiza una búsqueda de lugares asociados al término food.

Realizar una búsqueda de lugares

Para escribir una aplicación QML que muestre lugares en una lista, comenzamos haciendo las siguientes declaraciones de importación.

import QtQuick
import QtPositioning
import QtLocation

Instanciar una instancia de Plugin. El Plugin es efectivamente el backend desde donde se obtienen los lugares. Dependiendo del tipo de plugin, puede ser necesario rellenar algunos parámetros obligatorios. El tipo más probable de PluginParameter es algún tipo de token de acceso al servicio que está documentado en el plugin de servicio. En este fragmento se utiliza el complemento osm, que no requiere ningún otro parámetro:

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

A continuación instanciamos un PlaceSearchModel que podemos utilizar para especificar parámetros de búsqueda y realizar una operación de búsqueda de lugares. A título ilustrativo, update() se invoca una vez finalizada la construcción del modelo. Normalmente, update() se invocaría en respuesta a una acción del usuario como, por ejemplo, la pulsación de un botón.

PlaceSearchModel {
    id: searchModel

    plugin: myPlugin

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

    Component.onCompleted: update()

}

Finalmente instanciamos un ListView para mostrar los resultados de búsqueda encontrados por el modelo. Se ha utilizado un delegado en línea y hemos supuesto que cada resultado de búsqueda es de type PlaceSearchesult . En consecuencia se asume que siempre tenemos acceso al lugar role, otros tipos de resultado de búsqueda pueden no tener un lugar 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 }
            }
        }
    }
}

Proyecto de ejemplo @ code.qt.io