Mapa de lugares (QML)
El ejemplo «Mapa de lugares» muestra cómo buscar y mostrar una lista de lugares en un mapa utilizando un MapItemView.

El ejemplo muestra un mapa de la ubicación actual o, si no hay ninguna posición disponible, utiliza Oslo (Noruega). A continuación, se realiza una búsqueda de lugares que coincidan con el término «comida» y cada resultado se muestra en el mapa.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Búsqueda local
Para escribir la aplicación QML que mostrará lugares en un mapa, empezamos por realizar las siguientes declaraciones de importación.
import QtQuick
import QtPositioning
import QtLocationCreamos una instancia de ` Plugin `. El ` Plugin ` es, en la práctica, el backend del que se obtienen los lugares. Dependiendo del complemento elegido, es posible que se requieran algunos parámetros obligatorios. En este caso, se ha seleccionado el complemento OSM, que no tiene ningún parámetro obligatorio.
Plugin {
id: myPlugin
name: "osm"
//specify plugin parameters if 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(positionSource.lastSearchPosition, 1000 /* 1 km radius */)
Component.onCompleted: update()
}El mapa se muestra utilizando el tipo ` MapView ` y, en su interior, declaramos ` MapItemView ` y le proporcionamos el modelo de búsqueda y un delegado. Se ha utilizado un delegado en línea y hemos supuesto que todos los resultados de búsqueda son de tipo ` type ` ` PlaceSerachesult`. Por consiguiente, se supone que siempre tenemos acceso al objeto `place ` ` role`; otros tipos de resultados de búsqueda pueden no tener un objeto `place ` ` role`.
MapView {
id: view
anchors.fill: parent
map.plugin: myPlugin;
map.center: positionSource.lastSearchPosition
map.zoomLevel: 13
MapItemView {
model: searchModel
parent: view.map
delegate: MapQuickItem {
coordinate: place.location.coordinate
anchorPoint.x: image.width * 0.5
anchorPoint.y: image.height
sourceItem: Column {
Image { id: image; source: "marker.png" }
Text { text: title; font.bold: true }
}
}
}
}Por último, se utiliza un PositionSource para restablecer el mapa a la ubicación actual y buscar locales de «comida» en la nueva zona. La información de posición se actualiza cada 2 minutos y, si la nueva posición se encuentra a más de 500 metros de la última zona de búsqueda de comida, se vuelve a activar la búsqueda de locales.
PositionSource {
id: positionSource
property variant lastSearchPosition: QtPositioning.coordinate(59.93, 10.76) //Initialized/Fallback to Oslo
active: true
updateInterval: 120000 // 2 mins
onPositionChanged: {
var distance = lastSearchPosition.distanceTo(position.coordinate)
if (distance > 500) {
// 500m from last performed food search
lastSearchPosition = positionSource.position.coordinate
}
}
}© 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.