En esta página

MapPolygon QML Type

El tipo MapPolygon muestra un polígono en un mapa. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

El tipo MapPolygon muestra un polígono en un mapa, especificado mediante una lista ordenada de coordinates. Para obtener los mejores resultados y una mejor apariencia, los polígonos deben ser simples (sin intersecciones internas).

Las coordenadas se pueden añadir o eliminar en cualquier momento mediante los métodos ` addCoordinate ` y ` removeCoordinate `. También se pueden modificar como cualquier otro elemento de lista en QML:

mapPolygon.path[0].latitude = 5;

Para dibujar rectángulos con bordes «rectos» (la misma latitud a lo largo de un borde y la misma latitud a lo largo del otro), el tipo ` MapRectangle ` ofrece una API más sencilla de dos puntos.

Por defecto, el polígono se muestra como un borde negro de 1 píxel sin relleno. Para cambiar su apariencia, utiliza las propiedades color, border.color y border.width.

Nota: Dado que los MapPolygons son elementos geográficos, al arrastrar un MapPolygon (mediante el uso de MouseArea o PointHandler) se recalculan sus vértices en el espacio de coordenadas geográficas. Los bordes conservan las mismas longitudes geográficas (diferencias de latitud y longitud entre los vértices), pero siguen siendo rectos. Se produce un estiramiento aparente del elemento cuando se arrastra a una latitud diferente.

Ejemplo de uso

El siguiente fragmento de código muestra cómo se utiliza un MapPolygon para representar un triángulo con tres vértices cerca de Brisbane, Australia. El triángulo está relleno de color verde y tiene un borde negro de 1 píxel.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

Triángulo verde en un mapa

Documentación de propiedades

autoFadeIn : bool

Esta propiedad determina si el elemento aparece gradualmente al ampliar el mapa partiendo de niveles de zoom muy bajos. Por defecto, el valor es « true ». Si se establece esta propiedad en « false », el elemento del mapa tendrá siempre la opacidad especificada con la propiedad « QtQuick::Item::opacity », cuyo valor por defecto es 1,0.

border group

border.color : color

border.width : int

Esta propiedad forma parte del grupo de propiedades «border». El grupo de propiedades «border» contiene el ancho y el color que se utilizan para dibujar el borde del polígono.

El ancho se expresa en píxeles y es independiente del nivel de zoom del mapa.

Los valores por defecto corresponden a un borde negro con un ancho de 1 píxel. Para que no aparezca ninguna línea, utiliza un ancho de 0 o un color transparente.

color : color

Esta propiedad indica el color utilizado para rellenar el polígono.

El valor por defecto es transparente.

path : list<coordinate>

Esta propiedad contiene la lista ordenada de coordenadas que definen el polígono. Si la ruta tiene menos de 3 coordenadas diferentes, se produce un comportamiento indefinido.

Véase también addCoordinate y removeCoordinate.

referenceSurface : enum [since 6.5]

Esta propiedad determina la superficie de referencia del polígono. Si se establece en « QLocation::ReferenceSurface::Map », los vértices del polígono se conectan con líneas rectas en el mapa. Si se establece en « QLocation::ReferenceSurface::Globe », los vértices se conectan siguiendo la trayectoria del gran círculo, que describe la conexión más corta entre dos puntos en una esfera. El valor por defecto es « QLocation::ReferenceSurface::Map ».

Esta propiedad se introdujo en Qt 6.5.

Documentación del método

void addCoordinate(coordinate)

Añade el archivo « coordinate » especificado a la ruta.

Véase también removeCoordinate y path.

void removeCoordinate(coordinate)

Elimina « coordinate » de la ruta. Si hay varias entradas con la misma coordenada, se elimina la que se haya añadido en último lugar.

Si coordinate no está en la ruta, este método no hace nada.

Véase también addCoordinate y path.

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