MapCircle QML Type

El tipo MapCircle muestra un círculo geográfico en un Mapa. Más...

• Lista de todos los miembros, incluyendo los heredados
• MapCircle es parte de QML Maps Plugin.

Propiedades

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• center : coordinate
• color : color
• opacity : real
• radius : real
• referenceSurface : enum (since 6.5)

Descripción detallada

El tipo MapCircle muestra un círculo geográfico en un Mapa, que consiste en todos los puntos que están dentro de una distancia establecida desde un punto central. Dependiendo de la proyección del mapa, un círculo geográfico puede no ser siempre un círculo perfecto en la pantalla: por ejemplo, en la proyección Mercator, los círculos adquieren forma ovoide al acercarse a los polos. Para mostrar un círculo perfecto en pantalla alrededor de un punto, utilice en su lugar un MapQuickItem que contenga un tipo de Qt Quick relevante.

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

Internamente, un MapCircle se implementa como un polígono de muchos lados. Para calcular los puntos del radio utiliza un modelo esférico de la Tierra, similar al método atDistanceAndAzimuth del tipo de coordenadas. Estas dos cosas pueden ocasionalmente tener implicaciones en la precisión de la forma del círculo, dependiendo de la posición y la proyección del mapa.

Ejemplo de uso

El siguiente fragmento muestra un mapa que contiene un MapCircle, centrado en la coordenada (-27, 153) con un radio de 5 km. El círculo está relleno en 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
    }
}

Documentación de propiedades

autoFadeIn : bool

Esta propiedad establece si el elemento se desvanece automáticamente al hacer zoom en el mapa a partir de niveles de zoom muy bajos. Por defecto es true. Establecer esta propiedad a false hace que el elemento del mapa tenga siempre la opacidad especificada con la propiedad QtQuick::Item::opacity, que por defecto es 1.0.

border group

Esta propiedad forma parte de la propiedad del grupo borde. La propiedad border contiene la anchura y el color utilizados para dibujar el borde del círculo. La anchura se expresa en píxeles y es independiente del nivel de zoom del mapa.

Los valores por defecto corresponden a un borde negro con una anchura de 1 píxel. Para que no haya borde, utilice una anchura de 0 o un color transparente.

center : coordinate

Esta propiedad mantiene el punto central alrededor del cual se define el círculo.

Véase también radius.

color : color

Esta propiedad contiene el color de relleno del círculo cuando se dibuja. Para no rellenar, utilice un color transparente.

opacity : real

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

Un elemento con opacidad 0 seguirá recibiendo eventos de ratón. Para detener los eventos del ratón, establezca la propiedad visible del elemento a false.

radius : real

Esta propiedad contiene 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 representa en una esfera y se utiliza la trayectoria del círculo máximo para determinar la cobertura del círculo. El valor por defecto es QLocation::ReferenceSurface::Map.

Esta propiedad se introdujo en Qt 6.5.