MapCircle QML Type

MapCircle 型は、マップ上に地理的な円を表示します。詳細...

• 継承されたメンバーを含むすべてのメンバーの一覧
• MapCircleは、QML Mapsプラグインの一部です。

プロパティ

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

詳細な説明

MapCircle 型は、マップ上に地理的円を表示します。この円は、ある中心点から設定された距離内にあるすべての点で構成されます。 地図の投影法によっては、地理的な円が画面上で必ずしも完全な円とは限らない場合があります。例えば、メルカトル図法では、極に近づくにつれて円は楕円形になります。ある点を中心とする完全な円を画面上に表示するには、代わりに、関連するQt Quick 型を含むMapQuickItem を使用してください。

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

内部的には、MapCircleは多角形として実装されています。半径点の計算には、geoCoordinate のatDistanceAndAzimuthメソッドと同様に、地球の球面モデルが使用されます。位置や地図投影法によっては、これら2つの要素が円の形状の精度に影響を与える場合があります。

使用例

以下のスニペットは、座標 (-27, 153) を中心とし、半径 5km の MapCircle を含む地図を示しています。円は緑色で塗りつぶされ、3 ピクセルの黒い枠線が付けられています。

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

プロパティのドキュメント

autoFadeIn : bool

このプロパティは、非常に低いズームレベルから地図を拡大した際に、アイテムが自動的にフェードインするかどうかを指定します。デフォルトでは、true に設定されています。このプロパティをfalse に設定すると、地図上のアイテムは常にQtQuick::Item::opacity プロパティで指定された不透明度（デフォルトは1.0）で表示されます。

border group

このプロパティは、`border` グループプロパティの一部です。`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 で導入されました。