MapCircle QML Type

Le type MapCircle permet d'afficher un cercle géographique sur une carte. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• MapCircle fait partie de QML Maps Plugin.

Propriétés

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

Description détaillée

Le type MapCircle permet d'afficher sur une carte un cercle géographique composé de tous les points situés à une distance donnée d'un point central. Selon la projection cartographique, un cercle géographique n'est pas toujours un cercle parfait à l'écran : par exemple, dans la projection de Mercator, les cercles prennent une forme ovoïde lorsqu'ils s'approchent des pôles. Pour afficher un cercle parfait à l'écran autour d'un point, utilisez plutôt un site MapQuickItem contenant un type de Qt Quick approprié.

Par défaut, le cercle est affiché sous la forme d'une bordure noire de 1 pixel sans remplissage. Pour modifier son apparence, utilisez les propriétés color, border.color et border.width.

En interne, un MapCircle est implémenté comme un polygone à plusieurs côtés. Pour calculer les points du rayon, il utilise un modèle sphérique de la Terre, similaire à la méthode atDistanceAndAzimuth du type de coordonnées. Ces deux éléments peuvent parfois avoir des conséquences sur la précision de la forme du cercle, en fonction de la position et de la projection de la carte.

Exemple d'utilisation

L'extrait suivant montre une carte contenant un MapCircle, centré sur la coordonnée (-27, 153) avec un rayon de 5 km. Le cercle est rempli en vert, avec une bordure noire de 3 pixels.

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

Documentation sur les propriétés

autoFadeIn : bool

Cette propriété indique si l'élément s'estompe automatiquement lorsque l'on zoome sur la carte à partir d'un niveau de zoom très bas. La valeur par défaut est true. Si vous attribuez la valeur false à cette propriété, l'élément de la carte aura toujours l'opacité spécifiée par la propriété QtQuick::Item::opacity, qui est de 1,0 par défaut.

border group

Cette propriété fait partie de la propriété du groupe border. La propriété border contient la largeur et la couleur utilisées pour dessiner la bordure du cercle. La largeur est exprimée en pixels et est indépendante du niveau de zoom de la carte.

Les valeurs par défaut correspondent à une bordure noire d'une largeur de 1 pixel. Pour une absence de ligne, utilisez une largeur de 0 ou une couleur transparente.

center : coordinate

Cette propriété définit le point central autour duquel le cercle est défini.

Voir aussi radius.

color : color

Cette propriété définit la couleur de remplissage du cercle lorsqu'il est dessiné. Si le cercle n'est pas rempli, utilisez une couleur transparente.

opacity : real

Cette propriété définit l'opacité de l'élément. L'opacité est un nombre compris entre 0 (totalement transparent) et 1 (totalement opaque). La valeur par défaut est 1.

Un élément dont l'opacité est de 0 recevra toujours des événements de souris. Pour arrêter les événements de souris, définissez la propriété visible de l'élément sur false.

radius : real

Cette propriété contient le rayon du cercle, en mètres au sol.

Voir aussi center.

referenceSurface : enum [since 6.5]

Cette propriété détermine la surface de référence du cercle. Si elle vaut QLocation::ReferenceSurface::Map, le cercle est dessiné comme un cercle sur la carte avec radius approximé pour correspondre à l'échelle de la carte au centre du cercle. Si la valeur est QLocation::ReferenceSurface::Globe, le cercle est cartographié sur une sphère et la trajectoire du grand cercle est utilisée pour déterminer la couverture du cercle. La valeur par défaut est QLocation::ReferenceSurface::Map.

Cette propriété a été introduite dans Qt 6.5.