En esta página

MapCircle QML Type

El tipo MapCircle muestra un círculo geográfico en un mapa. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Descripción detallada

El tipo MapCircle muestra un círculo geográfico en un mapa, formado por todos los puntos que se encuentran a una distancia determinada de un punto central. Dependiendo de la proyección cartográfica, es posible que un círculo geográfico no siempre se vea como un círculo perfecto en la pantalla: por ejemplo, en la proyección de Mercator, los círculos adquieren una forma ovoide a medida que se acercan a los polos. Para mostrar un círculo perfecto en pantalla alrededor de un punto, utiliza en su lugar un objeto ` MapQuickItem ` que contenga un objeto del tipo ` Qt Quick ` adecuado.

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

Internamente, un MapCircle se implementa como un polígono de múltiples lados. Para calcular los puntos del radio, utiliza un modelo esférico de la Tierra, similar al método atDistanceAndAzimuth de geoCoordinate. Estos dos factores pueden, en ocasiones, afectar a la precisión de la forma del círculo, dependiendo de la posición y la proyección del mapa.

Nota: Al arrastrar un MapCircle (mediante el uso de MouseArea o PointHandler) se generan nuevos puntos a la misma distancia (en metros) del centro. Esto contrasta con otros elementos del mapa, que almacenan sus dimensiones en términos de diferencias de latitud y longitud entre vértices.

Ejemplo de uso

El siguiente fragmento de código muestra un mapa que contiene un MapCircle, centrado en la coordenada (-27, 153) con un radio de 5 km. El círculo está relleno de color verde, con un borde negro de 3 píxeles.

Map {
    MapCircle {
        center {
            latitude: -27.5
            longitude: 153.0
        }
        radius: 5000.0
        color: 'green'
        border.width: 3
    }
}

Círculo 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 de la propiedad agrupada «border». La propiedad «border» especifica el ancho y el color que se utilizan para dibujar el borde del círculo. El ancho se expresa en píxeles y es independiente del nivel de zoom del mapa.

Los valores predeterminados 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.

center : coordinate

Esta propiedad establece el punto central en torno al cual se define el círculo.

Véase también radius.

color : color

Esta propiedad determina el color de relleno del círculo al dibujarlo. Si no quieres que se rellene, utiliza un color transparente.

opacity : real

Esta propiedad determina la opacidad del elemento. La opacidad se especifica como un número comprendido entre 0 (totalmente transparente) y 1 (totalmente opaco). El valor por defecto es 1.

Un elemento con opacidad 0 seguirá recibiendo eventos del ratón. Para detener los eventos del ratón, establece la propiedad «visible» del elemento en «false».

radius : real

Esta propiedad indica el radio del círculo, en metros sobre el suelo.

Véase también center.

referenceSurface : enum [since 6.5]

Esta propiedad determina la superficie de referencia del círculo. Si se establece en « QLocation::ReferenceSurface::Map », el círculo se dibuja como un círculo en el mapa con « radius » aproximado para que coincida con la escala del mapa en el centro del círculo. Si se establece en « QLocation::ReferenceSurface::Globe », el círculo se proyecta sobre una esfera y se utiliza la trayectoria del gran círculo para determinar la cobertura del círculo. El valor por defecto es « QLocation::ReferenceSurface::Map ».

Esta propiedad se introdujo en Qt 6.5.

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