Back to Qt.io
Contact Us Blog Download Qt

MapCircle QML Type

MapCircle 유형은 맵에 지리적 원을 표시합니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

속성

상세 설명

MapCircle 유형은 하나의 중심점으로부터 설정된 거리 내에 있는 모든 점으로 구성된 지리적 원을 맵에 표시합니다. 지도 투영법에 따라 지리적 원이 항상 화면에서 완벽한 원이 아닐 수도 있습니다. 예를 들어 메르카토르 투영법에서는 원이 극에 가까워질수록 원 모양이 타원이 됩니다. 점 주위에 완벽한 화면 원을 표시하려면 대신 관련 Qt Quick 유형이 포함된 MapQuickItem 을 사용합니다.

기본적으로 원은 채우기가 없는 1픽셀 검은색 테두리로 표시됩니다. 모양을 변경하려면 color, border.color 및 border.width 속성을 사용합니다.

내부적으로 MapCircle은 다각형으로 구현됩니다. 반경 지점을 계산하기 위해 coordinate 유형의 atDistanceAndAzimuth 메서드와 유사한 지구의 구형 모델을 사용합니다. 이 두 가지는 위치 및 지도 투영에 따라 원 모양의 정확도에 영향을 미칠 수 있습니다.

참고: MapCircle을 드래그( MouseArea 또는 PointHandler)하면 중심에서 동일한 거리(미터 단위)에 새 점이 생성됩니다. 이는 정점 간의 위도 및 경도 차이로 치수를 저장하는 다른 맵 항목과 대조적입니다.

사용 예

다음 코드 조각은 좌표(-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.color : color

border.width : int

이 속성은 테두리 그룹 속성의 일부입니다. 테두리 속성은 원의 테두리를 그리는 데 사용되는 너비와 색상을 보유합니다. 너비는 픽셀 단위이며 맵의 확대/축소 수준과 무관합니다.

기본값은 너비가 1픽셀인 검은색 테두리에 해당합니다. 선이 없는 경우 너비 0 또는 투명한 색상을 사용합니다.


center : coordinate

이 속성은 원이 정의되는 중심점을 보유합니다.

radius 를참조하세요 .


color : color

이 속성은 그려질 때 원의 채우기 색을 유지합니다. 채우기를 사용하지 않으려면 투명한 색을 사용합니다.


opacity : real

이 속성은 항목의 불투명도를 보유합니다. 불투명도는 0(완전 투명)에서 1(완전 불투명) 사이의 숫자로 지정됩니다. 기본값은 1입니다.

불투명도가 0인 항목은 마우스 이벤트를 계속 수신합니다. 마우스 이벤트를 중지하려면 항목의 가시성 속성을 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.