En esta página

GeoJsonData QML Type

Un modelo para representar, cargar y guardar documentos GeoJSON. Más...

Import Statement: import QtLocation 6.12
Since: QtLocation 6.7

Propiedades

Métodos

Descripción detallada

El tipo GeoJsonData lee y escribe documentos con formato GeoJson. GeoJsonData dispone de funciones para abrir y guardar el modelo en la URL establecida en la propiedad sourceUrl. El modelo cargado se representa internamente mediante QVariant y se vincula a la propiedad model. Utiliza delegados para visualizar los elementos en una vista.

Para obtener información sobre GeoJSON, visita el sitio web de GeoJSON.

Objeto GeoJSON

El objeto GeoJSON es un objeto JSON válido que representa una geometría, una entidad o una colección de geometrías o entidades.

Un objeto GeoJSON debe ser de uno de estos tipos:

  • Point
  • MultiPoint
  • LineString
  • MultiLineString
  • Polygon
  • MultiPolygon
  • GeometryCollection
  • Feature
  • FeatureCollection

Para establecer el tipo, vincule el miembro « type » a un tipo GeoJSON. El miembro « coordinates » puede ser un tipo de « QGeoShape » o una lista, dependiendo del tipo de GeoJSON. El tipo « Feature » tiene los miembros adicionales « geometry » y « properties ».

Lista de los tipos geométricos y sus representaciones equivalentes en QVariant:

  • Para un objeto ` Point `, ` coordinates ` se empareja con ` QGeoCircle`. Por ejemplo:
    {
        "type": "Point",
        "coordinates": [11, 60]
    }

    Este objeto GeoJSON tiene una representación « QVariantMap » correspondiente:

    {
        type: "Point"
        coordinates: QGeoCircle({11.000, 60.000}, -1)
    }
  • Para un objeto LineString, coordinates se empareja con QGeoPath. Por ejemplo:
    {
        "type" : "LineString",
        "coordinates" : [
        [13.5, 43],
        [10.73, 59.92]
        ]
    }

    Este objeto GeoJSON tiene una representación correspondiente en QVariantMap:

    {
        type : "LineString"
        data : QGeoPath([{43.000, 13.500}, {59.920, 10.730}])
    }
  • Para un objeto Polygon, el miembro coordinates se empareja con QGeoPolygon (puede haber huecos). El polígono es un anillo lineal, cuya coordenada final es la misma que la primera, lo que abre y cierra el anillo. El miembro bbox es opcional y sirve para establecer el rango del área, lo cual resulta útil para límites cóncavos. Para obtener más información sobre las coordenadas de polígono aceptadas, consulta la sección sobre el tipo «Polygon» en la especificación GeoJSON. Por ejemplo:
    {
        "type": "Polygon",
        "coordinates": [
            [
                [17.13, 51.11],
                [30.54, 50.42],
                [26.70, 58.36],
                [17.13, 51.11]
            ]
        ],
        "bbox": [50, -50, 10, -10]
    }

    Este objeto GeoJSON tiene una representación correspondiente en « QVariantMap »:

    {
        type : "Polygon"
        coordinates : QGeoPolygon([{51.110, 17.130}, {50.420,30.540}, {58.360, 26.700}, {51.110, 17.130}])
    }

Para los tipos « MultiPoint », « MultiLineString » y « MultiPolygon », « coordinates » se combina con un « QVariantList ». El elemento de la lista es un « QVariantMap » que contiene geometría.

  • En el caso de un objeto ` MultiPoint `, ` coordinates ` se empareja con una lista de coordenadas de tipo `Point`. Por ejemplo:
    {
        "type": "MultiPoint",
        "coordinates": [
            [11, 60],
            [5.5, 60.3],
            [5.7, 58.90]
        ]
    }

    Este objeto GeoJSON tiene una representación correspondiente en QVariantMap:

    {
        type : "MultiPoint"
        coordinates : [
            {
                type : "Point"
                coordinates : QGeoCircle({60.000, 11.000}, -1)
            },
            {
                type : "Point"
                coordinates : QGeoCircle({60.300, 5.500}, -1)
            },
            {
                type : "Point"
                coordinates : QGeoCircle({58.900, 5.700}, -1)
            }
            ]
    }
  • En el caso de un objeto « MultiLineString », « coordinates » se asocia a una lista de coordenadas de «LineString». El siguiente objeto GeoJSON construye dos líneas no paralelas:
    {
        "type" : "MultiLineString",
        "coordinates" : [
        [[13.5, 43], [10.73, 59.92]],
        [[9.15, 45], [-3.15, 58.90]]
        ]
    }

    Este objeto GeoJSON tiene una representación QVariantMap correspondiente:

    {
        type : "MultiLineString"
        coordinates : [
            {
                type : "LineString"
                coordinates : QGeoPath([{45.000, 9.150}, {58.900, -3.150}])
            },
            {
                type : "LineString"
                coordinates : QGeoPath([{43.000, 13.500}, {59.920, 10.730}])
            }
        ]
    }
  • Para un tipo « MultiPolygon », los pares « coordinates » se combinan con una lista de coordenadas de «Polygon». El polígono es un anillo lineal y el tipo « Polygon » contiene más información sobre los formatos aceptados. El siguiente objeto GeoJSON contiene una lista de dos triángulos:
    {
        "type" : "MultiPolygon",
        "coordinates" : [
        [
            [[17.13, 51.11],
            [30.54, 50.42],
            [26.74, 58.36],
            [17.13, 51.11]
            ]],
        [
            [[19.84, 41.33],
            [30.45, 49.26],
            [17.07, 50.10],
            [19.84, 41.33]
            ]]
        ]
    }

    Este objeto GeoJSON tiene una representación correspondiente en QVariantMap:

    {
        type : "MultiPolygon"
        coordinates : [
            {
                type : "Polygon"
                coordinates : QGeoPolygon([{51.110, 17.130}, {50.420,30.540}, {58.360, 26.740}])
            },
            {
                type : "Polygon"
                coordinates : QGeoPolygon([{41.330, 19.840}, {49.260,30.450}, {50.100, 17.070}])
            }
            ]
    }

El tipo « GeometryCollection » es una composición de otros tipos de geometría. El valor del miembro « geometries » es una « QVariantList » que contiene «QVariantMaps» de varios tipos, incluidos otros tipos de «GeometryCollection».

Por ejemplo, el siguiente tipo de « GeometryCollection » contiene varias geometrías más:

{
    "type" : "GeometryCollection",
    "geometries" : [
        {
            "type" : "MultiPoint",
            "coordinates" : [
                [11,60], [5.5,60.3], [5.7,58.90]
            ]
        },
        {
            "type" : "MultiLineString",
            "coordinates": [
                [[13.5, 43], [10.73, 59.92]],
                [[9.15, 45], [-3.15, 58.90]]
            ]
        },
        {
            "type" : "MultiPolygon",
            "coordinates" : [
                [
                    [
                        [17.13, 51.11],
                        [30.54, 50.42],
                        [26.74, 58.36],
                        [17.13, 51.11]
                    ]
                ],
                [
                    [
                        [19.84, 41.33],
                        [30.45, 49.26],
                        [17.07, 50.10],
                        [19.84, 41.33]
                    ]
                ]
            ]
        }
    ]
}

Este objeto GeoJSON tiene una representación correspondiente de tipo « QVariantMap »:

{
  type : "GeometryCollection"
  coordinates : [
    {
      type : "MultiPolygon"
      coordinates : [
        {
          type : "Polygon"
          coordinates : QGeoPolygon([{41.330, 19.840}, {49.260, 30.450}, {50.100, 17.070}])
        },
        {
          type : "Polygon"
          coordinates : QGeoPolygon([{51.110, 17.130}, {50.420, 30.540}, {58.360, 26.740}])
        }
      ]
    }
    {
      type : "MultiLineString"
      coordinates : [
        {
          type : "LineString"
          coordinates : QGeoPath([{45.000, 9.150}, {58.900, -3.150}])
        },
        {
          type : "LineString"
          coordinates : QGeoPath([{43.000, 13.500}, {59.920, 10.730}])
        }
      ]
    }
    {
      type : "MultiPoint"
      coordinates : [
        {
          type : Point
          coordinates : QGeoCircle({58.900, 5.700}, -1)
        },
        {
          type : Point
          coordinates : QGeoCircle({60.300, 5.500}, -1)
        },
        {
          type : Point
          coordinates : QGeoCircle({60.000, 11.000}, -1)
        }
      ]
    }
  ]
}

El tipo « Feature » contiene un miembro adicional « geometry » y « properties ». La única forma de distinguir un objeto «Feature» de otros objetos geométricos es comprobar la existencia de un nodo « properties » en el objeto « QVariantMap ».

Por ejemplo, el siguiente Feature tiene miembros «geometry» y «properties»:

{
    "type": "Feature",
    "id": "Poly",
    "properties": {
        "name": "Poly",
        "text": "This is a Feature with a Polygon",
        "color": "limegreen"
    },
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [17.13, 51.11],
                [30.54, 50.42],
                [26.70, 58.36],
                [17.13, 51.11]
            ],
            [
                [23.46, 54.36],
                [20.52, 51.91],
                [28.25, 51.50],
                [26.80, 54.36],
                [23.46, 54.36]
            ]
        ]
    }
}

Este objeto GeoJSON tiene una representación correspondiente en QVariantMap:

{
  type : "Polygon"
  data : QGeoPolygon([{51.110, 17.130}, {50.420,30.540}, {58.360, 26.700}, {51.110, 17.130}])
  properties : {text : "This is a Feature with a Polygon"}
}

El FeatureCollection es una composición de objetos Feature. El miembro features se vincula a un objeto QVariantList que contiene otros objetos Feature.

Por ejemplo, el siguiente « FeatureCollection » contiene varias «Features» y geometrías:

{
    "type" : "FeatureCollection",
    "properties" : {
        "color" : "crimson"
    },
    "features" : [
        {
            "type" : "Feature",
            "id" : "Poly",
            "properties" : {
                "text" : "This is a Feature with a Polygon"
            },
            "geometry" : {
            "type" : "Polygon",
            "coordinates" : [
                [
                    [17.13, 51.11],
                    [30.54, 50.42],
                    [26.70, 58.36],
                    [17.13, 51.11]
                ],
                [
                    [23.46, 54.36],
                    [20.52, 51.91],
                    [28.25, 51.50],
                    [26.80, 54.36],
                    [23.46, 54.36]
                ]
            ]
        }
    },
    {
        "type" : "Feature",
        "id" : "MultiLine",
        "properties" : {
            "text" : "This is a Feature with a MultiLineString",
            "color" : "deepskyblue"
        },
        "geometry" : {
            "type" : "MultiLineString",
            "coordinates" : [
                [[13.5, 43], [10.73, 59.92]],
                [[9.15, 45], [-3.15, 58.90]]
            ]
        }
    }
    ]
}

Este objeto GeoJSON tiene una representación correspondiente en formato QVariantMap:

{
    type: "FeatureCollection"
    data: [{
            type: "MultiLineString"
            data: [{
                type: "LineString"
                data: QGeoPath( [{45.000, 9.150}, {58.900, -3.150}] )
            } {
                type: "LineString"
                data: QGeoPath( [{43.000, 13.500}, {59.920, 10.730}] )
            }]
            properties: { text: "This is a Feature with a MultiLineString" }
        },
        {
            type: "Polygon"
            data: QGeoPolygon(  {51.110, 17.130},
                                {50.420, 30.540},
                                {58.360, 26.700},
                                {51.110, 17.130}
                            )
            properties: { text: "This is a Feature with a Polygon" }
        }
    ]
}

Ejemplo de GeoJSON

El ejemplo «GeoJSON Viewer » muestra cómo utilizar el tipo QML «GeoJsonData» para cargar y visualizar coordenadas en un mapa.

Documentación de propiedades

model : QVariant [since 6.7]

Una representación de tipo « QVariant » del documento GeoJSON. Los delegados de QML pueden mostrar el contenido en vistas.

Esta propiedad se introdujo en Qt 6.7.

sourceUrl : url [since 6.7]

La URL de un documento GeoJSON. Al establecer esta propiedad, se carga el documento y se vincula el objeto al miembro ` model `.

Esta propiedad se introdujo en Qt 6.7.

Documentación de métodos

bool addItem(Item item)

Añade el objeto ` item ` al objeto ` model `.

Devuelve ` true ` si la adición se realiza correctamente; en caso contrario, devuelve ` false `.

void clear()

Elimina todos los elementos vinculados a « model ».

bool open()

Carga el contenido del archivo disponible en sourceUrl.

Devuelve true si la apertura se realiza correctamente; en caso contrario, devuelve false.

bool openUrl(Url url)

Carga el documento GeoJSON de url y lo vincula a model. La propiedad sourceUrl se establece en url si la apertura del archivo se realiza correctamente.

Devuelve true si la apertura se realiza correctamente; en caso contrario, devuelve false.

bool save()

Guarda el modelo en sourceUrl.

Devuelve true si el guardado se realiza correctamente; de lo contrario, devuelve false.

bool saveAs(Url url)

Guarda el objeto ` model ` en ` url`. La propiedad ` sourceUrl ` se establece en ` url ` si la operación se realiza correctamente.

Devuelve true si el guardado se ha realizado correctamente; de lo contrario, devuelve false.

void setModelToMapContents(MapView mapItemView)

Añade todos los elementos del mapa de mapItemView a la model del objeto GeoJsonData. Elimina los elementos del mapa almacenados anteriormente de la model.

Devuelve « true » si la configuración se realiza correctamente; en caso contrario, devuelve « false ».

Véase también addItem.

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