Visor de GeoJSON (QML)
El ejemplo del visor GeoJson muestra cómo manipular MapItems, gestionar las entradas del usuario y las operaciones de E/S hacia y desde un archivo GeoJson.

El ejemplo muestra un mapa con varios MapItems. Los MapItems se importan desde un archivo GeoJson, utilizando la API « GeoJsonData » de QtLocation, o bien los dibuja el usuario mediante TapHandlers.
Se pueden encontrar ejemplos de archivos GeoJSON en el directorio «data» dentro del directorio de ejemplos.
Para dibujar un elemento de mapa (MapItem), haz clic con el botón derecho en una zona vacía del mapa y selecciona el tipo de elemento que desees en el menú que aparece. Los siguientes clics definirán el elemento elegido. El ejemplo permite dibujar MapCircles, MapRectangles, MapPolygons y MapPolylines. Los elementos que se definen completamente mediante dos puntos, es decir, círculos y rectángulos, se dibujan con dos clics del botón izquierdo del ratón. Los elementos que se definen mediante varios puntos, es decir, polígonos y polilíneas, se crean con un número arbitrario de clics con el botón izquierdo y se completan con el botón derecho del ratón. Los elementos trazados de esta forma se guardan como puntos, polígonos y polilíneas para ajustarse a la especificación GeoJSON; véase https://geojson.org/.
Ejecución del ejemplo
Puede 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.
Creación de un MapView
En primer lugar, creamos un mapa base sobre el que se puedan colocar todos los elementos. Aprovechamos un elemento MapView que combina un Map básico con la gestión de entradas (rueda del ratón, arrastre, etc.). Se puede acceder al Map subyacente mediante la propiedad map. Si echas en falta alguna propiedad en MapView, lo más probable es que puedas acceder a ella mediante MapView.map.
MapView {
id: view
anchors.fill: parent
map.plugin: Plugin { name: "osm" }
map.zoomLevel: 4
map.center: QtPositioning.coordinate(3, 8)
}Configuración del modelo GeoJSON / Visualización de MapItems
Para mostrar el contenido del archivo en el mapa, utilizaremos un patrón de diseño conocido como «programación Modelo/Vista». En primer lugar, debemos configurar una vista adecuada; en este ejemplo, un elemento MapItemView. Su elemento padre debe establecerse como el mapa subyacente de MapView para que se muestren correctamente todos los elementos colocados en él.
MapItemView {
id: miv
parent: view.map
}A continuación, necesitamos un modelo adecuado que represente un documento GeoJSON. Para ello, QtLocation ofrece el elemento GeoJsonData, capaz de leer y escribir archivos GeoJSON. Se puede instanciar fácilmente
GeoJsonData {
id: geoDatabase
sourceUrl: ":/data/11-full.json"
}y asignarse a MapItemView.
model: geoDatabase.modelEl archivo « 11-full.json » se carga al iniciar como ejemplo.
Por último, necesitamos un ` delegate`, que traduzca los datos del modelo a una representación de elementos y rellene el ` MapItemView`.
delegate: GeoJsonDelegate {}El elemento « GeoJsonDelegate » se declara en el archivo « GeoJsonDelegate.qml ». Se trata de un elemento « DelegateChooser », para tener en cuenta las propiedades variables de los distintos tipos de geometría.
DelegateChooser {
id: dc
role: "type"
}El elemento « DelegateChooser » contiene un « DelegateChoice » para cada tipo de geometría que pueda encontrarse en un archivo GeoJSON. La propiedad « role » se comparará con « DelegateChoice.roleValue » para determinar el delegado correcto.
A modo de ejemplo, un punto, descrito con "type":"Point" en GeoJSON, se representa mediante un MapCircle en la MapItemView:
DelegateChoice {
roleValue: "Point"
delegate: MapCircle {
property string geojsonType: "Point"
property var props: modelData.properties
geoShape: modelData.data
radius: (props && props.radius) || 20*1000
border.width: 2
border.color: hh.hovered ? "magenta" : Qt.darker(color)
opacity: dc.defaultOpacity
color: (props && props.color) || (parent && parent.props && parent.props.color) || dc.defaultColor
}
}Se intenta leer las propiedades de MapCircle, como color o radius, a partir del archivo GeoJSON disponible en forma de la propiedad modelData. Sin embargo, esto no es un estándar estricto de GeoJSON y se establecen valores por defecto para todas las propiedades.
Escribir MapItems en GeoJSON
Para escribir MapItems en un archivo GeoJSON, basta con llamar a la función ` GeoJsonData::saveAs ` con el nombre de archivo indicado. Esto escribe todos los elementos del modelo actual en el archivo especificado. Cualquier otro elemento que deba escribirse en el archivo debe añadirse primero al modelo mediante la función ` GeoJsonData::addItem ` o ` GeoJsonData::setModelToMapContents`.
geoDatabase.saveAs(fileWriteDialog.selectedFile)Interacción del usuario con los MapItems
Para gestionar las interacciones del usuario utilizaremos los PointHandlers. Son especialmente adecuados para esta tarea, ya que se ajustan a la forma exacta del elemento subyacente, a diferencia de los MouseArea, que siempre cubren una forma cuadrada. Los MapItems importados desde un archivo GeoJSON obtienen sus propios HoverHandler y TapHandler directamente en el delegado:
TapHandler {
onTapped: {
if (props !== undefined)
console.log(props.name)
else if (parent.parent.geojsonType == "MultiPoint")
console.log(parent.parent.props.name)
else
console.log("NO NAME!", props)
}
}
HoverHandler {
id: hh
}La propiedad « TapHandler » se utiliza para escribir información sobre el elemento en la consola cuando se pulsa sobre él. La propiedad « HoverHandler » se utiliza para resaltar los elementos que se encuentran debajo del puntero del ratón. Esto se implementa describiendo la propiedad « border.color » en función de la propiedad o estado « hovered » del « HoverHandler ».
Añadir nuevos elementos
Una combinación de HoverHandler y TapHandler para la propiedad MapView nos permite reaccionar a los movimientos del ratón y a los clics del usuario.
Si el TapHandler emite una señal singleTapped, crearemos o modificaremos un nuevo MapItem en LeftButton y finalizaremos el MapItem en RightButton. Si no hay ningún elemento que finalizar, el RightButton abrirá un menú.
onSingleTapped: (eventPoint, button) => {
lastCoordinate = view.map.toCoordinate(tapHandler.point.position)
if (button === Qt.RightButton) {
if (view.unfinishedItem !== undefined) {
view.finishGeoItem()
} else
mapPopupMenu.show(lastCoordinate)
} else if (button === Qt.LeftButton) {
if (view.unfinishedItem !== undefined) {
if (view.unfinishedItem.addGeometry(view.map.toCoordinate(tapHandler.point.position), false)) {
view.finishGeoItem()
}
}
}
}La señal pointChanged se utiliza para actualizar temporalmente un MapItem, ofreciendo al usuario una vista previa.
HoverHandler {
id: hoverHandler
property variant currentCoordinate
grabPermissions: PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType
onPointChanged: {
currentCoordinate = view.map.toCoordinate(hoverHandler.point.position)
if (view.unfinishedItem !== undefined)
view.unfinishedItem.addGeometry(view.map.toCoordinate(hoverHandler.point.position), true)
}
}Los MapItems se generan a partir de prototipos definidos en archivos QML independientes. Se crean mediante la función « createComponent » y se añaden al mapa con « addMapItem ». Se almacena una referencia al nuevo elemento para que el usuario pueda manipularlo posteriormente.
function addGeoItem(item)
{
var co = Qt.createComponent('mapitems/'+item+'.qml')
if (co.status === Component.Ready) {
unfinishedItem = co.createObject(map)
unfinishedItem.setGeometry(tapHandler.lastCoordinate)
unfinishedItem.addGeometry(hoverHandler.currentCoordinate, false)
view.map.addMapItem(unfinishedItem)
} else {
console.log(item + " is not supported right now, please call us later.")
}
}Basta con añadir el elemento a ` Map ` para que se muestre. Sin embargo, para poder seguir utilizando el elemento (por ejemplo, guardarlo en un archivo), hay que añadirlo al modelo. Esto se hace una vez finalizada la edición:
function finishGeoItem()
{
unfinishedItem.finishAddGeometry()
geoDatabase.addItem(unfinishedItem)
map.removeMapItem(unfinishedItem)
unfinishedItem = undefined
}Eliminación de elementos
Para eliminar todos los elementos del mapa, basta con llamar a la función de reinicio del objeto ` GeoJsonData `
function clearAllItems()
{
geoDatabase.clear();
}© 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.