MapCircle QML Type

MapCircle タイプは、地図上に地理的な円を表示します。詳細...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

継承されたメンバを含むすべてのメンバの一覧
MapCircle はQML Maps Plugin に含まれます。

プロパティ

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

詳細説明

MapCircle 型は、1 つの中心点から設定された距離内にあるすべての点で構成される地理的な円を Map 上に表示します。例えば、メルカトル図法では、極に近づくにつれて円の形が卵型になります。例えば、メルカトル図法の場合、円は極に近づくにつれて卵型になります。点の周りに完全な円を表示するには、代わりにQt Quick タイプを含むMapQuickItem を使用してください。

デフォルトでは、円は塗りつぶしのない1ピクセルの黒枠で表示されます。その外観を変更するには、color 、border.color 、border.width プロパティを使用します。

内部的には MapCircle は多角形として実装されています。半径点を計算するために、coordinate タイプのatDistanceAndAzimuth メソッドと同様に、地球の球体モデルを使用します。これらの2つのことは、位置と地図投影法によっては円の形状の正確さに影響を与えることがあります。

注：（MouseArea またはPointHandler を使って）MapCircle をドラッグすると、中心から同じ距離（メートル単位）に新しい点が生成される。これは頂点間の緯度と経度の差で寸法を保存する他のマップアイテムとは対照的です。

使用例

次のスニペットは座標(-27, 153)を中心とした半径 5km の MapCircle を含むマップを示しています。円は緑で塗りつぶされ、3ピクセルの黒い境界線がある。

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

プロパティ Documentation

autoFadeIn : bool

このプロパティは、非常に低いズームレベルから地図にズームインするときに、項目が自動的にフェードインするかどうかを保持します。デフォルトではtrue です。このプロパティをfalse に設定すると、マップアイテムは常にQtQuick::Item::opacity プロパティで指定された不透明度を持つようになり、デフォルトでは 1.0 になります。

border group
border.color : color
border.width : int

このプロパティは border group プロパティの一部です。border プロパティは、円の境界を描画するために使用される幅と色を保持します。幅はピクセル単位で、地図のズームレベルとは無関係です。

デフォルト値は幅1ピクセルの黒枠に対応します。線を引かない場合は、幅 0 または透明色を使用します。

center : coordinate

このプロパティは、円が定義される中心点を保持します。

radiusも参照。

color : color

このプロパティは、描画時の円の塗りつぶし色を保持します。塗りつぶしなしの場合は、透明色を使用します。

opacity : real

このプロパティは、項目の不透明度を保持する。不透明度は 0（完全に透明）から 1（完全に不透明）の間の数値で指定する。デフォルトは 1 です。

不透明度が 0 のアイテムは、マウスイベントをまだ受け取ります。マウスイベントを停止するには、アイテムの visible プロパティを false に設定します。

radius : real

このプロパティは、円の半径を地上メートル単位で保持します。

centerも参照してください。

referenceSurface : enum [since 6.5]

このプロパティは、円の基準面を決定します。これがQLocation::ReferenceSurface::Map に設定されている場合、円は地図上の円として描かれ、radius は円の中心で地図の縮尺と一致するように近似されます。これがQLocation::ReferenceSurface::Globe に設定されている場合、円は球にマップされ、円の範囲を決定するために大円パスが使用されます。デフォルト値はQLocation::ReferenceSurface::Map です。

このプロパティは Qt 6.5 で導入されました。

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