En esta página

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.

Mapa de Europa con un polígono y una polilínea superpuestos

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:

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.model

El 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();
}

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.