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 메서드와 유사한 지구 구면 모델을 사용합니다. 위치와 지도 투영법에 따라 이 두 가지 요소가 원의 모양 정확도에 영향을 미칠 수 있습니다.

사용 예시

다음 코드 조각은 좌표 (-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에서 도입되었습니다.