En esta página

Lista de lugares (QML)

El ejemplo «Lista de lugares» muestra cómo buscar y mostrar una lista de lugares utilizando un ` ListView`.

Lista numerada de pizzerías con sus direcciones

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

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

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

import QtQuick
import QtPositioning
import QtLocation

Instanciamos una instancia de ` Plugin `. El ` Plugin ` es, en la práctica, el backend del que se obtienen los lugares. Dependiendo del tipo de complemento, puede que sea necesario rellenar algunos parámetros obligatorios. El tipo más probable de ` PluginParameter ` son, en algún formato, tokens de acceso al servicio, que se documentan en el complemento del servicio. En este fragmento de código se utiliza el complemento ` osm `, que no requiere ningún parámetro adicional:

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 modo de ejemplo, se invoca ` update()` una vez finalizada la construcción del modelo. Normalmente, ` update()` se invocaría en respuesta a una acción del usuario, como hacer clic en un botón.

PlaceSearchModel {
    id: searchModel

    plugin: myPlugin

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

    Component.onCompleted: update()

}

Por último, 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 todos los resultados de búsqueda son de tipo ` type ` ` PlaceSearchesult`. Por consiguiente, se supone que siempre tenemos acceso al ` place ` ` role`; otros tipos de resultados de búsqueda pueden no tener 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 }
            }
        }
    }
}

Proyecto de ejemplo en @ code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.