Back to Qt.io
Contact Us Blog Download Qt

MapPolygon QML Type

맵폴리곤 유형은 맵에 다각형을 표시합니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

속성

방법

상세 설명

맵폴리곤 유형은 coordinates 의 정렬된 목록으로 지정된 다각형을 맵에 표시합니다. 최상의 모양과 결과를 얻으려면 다각형은 단순해야 합니다(자체 교차하지 않음).

다각형에 추가한 후에는 경로의 coordinates 을 직접 변경할 수 없습니다. 대신 path 을 var에 복사하고 복사본을 수정한 다음 path 에 다시 할당합니다.

var path = mapPolygon.path;
path[0].latitude = 5;
mapPolygon.path = path;

addCoordinate 및 removeCoordinate 메서드를 사용하여 언제든지 좌표를 추가하고 제거할 수도 있습니다.

"직선" 가장자리가 있는 직사각형(한쪽 가장자리의 위도가 같고 다른 쪽 가장자리의 위도가 같음)을 그리는 경우 MapRectangle 유형은 더 간단한 2점 API를 제공합니다.

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

참고: 맵폴리곤은 지리적 항목이므로 MouseArea 또는 PointHandler)을 사용하여 맵폴리곤을 끌면 지리적 좌표 공간에서 꼭지점이 다시 계산됩니다. 가장자리는 동일한 지리적 길이(정점 간의 위도 및 경도 차이)를 유지하지만 직선을 유지합니다. 다른 위도로 드래그하면 항목이 겉으로 보기에 늘어나는 현상이 발생합니다.

사용 예

다음 코드 조각은 호주 브리즈번 근처에 3개의 꼭지점이 있는 삼각형을 표시하는 데 사용되는 MapPolygon을 보여줍니다. 삼각형은 녹색으로 채워져 있으며 테두리는 1픽셀 검은색입니다.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

속성 문서

autoFadeIn : bool

이 속성은 매우 낮은 줌 레벨부터 맵을 확대할 때 항목이 자동으로 페이드 인할지 여부를 지정합니다. 기본값은 true 입니다. 이 속성을 false 로 설정하면 맵 항목에 항상 QtQuick::Item::opacity 속성(기본값은 1.0)으로 지정된 불투명도가 적용됩니다.


border group

border.color : color

border.width : int

이 속성은 테두리 속성 그룹의 일부입니다. 테두리 속성 그룹에는 다각형의 테두리를 그리는 데 사용되는 너비와 색상이 있습니다.

너비는 픽셀 단위이며 맵의 확대/축소 수준과 무관합니다.

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


color : color

이 속성은 다각형을 채우는 데 사용되는 색을 보유합니다.

기본값은 투명입니다.


path : list<coordinate>

이 속성은 다각형을 정의하는 좌표의 정렬된 목록을 보유합니다. 경로에 서로 다른 좌표가 3개 미만이면 정의되지 않은 동작이 발생합니다.

addCoordinate 및 removeCoordinate 을참조하십시오 .


referenceSurface : enum [since 6.5]

이 속성은 다각형의 참조 서페이스를 결정합니다. QLocation::ReferenceSurface::Map 로 설정된 경우 다각형 꼭지점은 맵에서 직선으로 연결됩니다. QLocation::ReferenceSurface::Globe 으로 설정된 경우 정점은 구에서 두 점을 최단거리로 연결하는 큰원 경로를 따라 연결됩니다. 기본값은 QLocation::ReferenceSurface::Map 입니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.


메서드 문서

void addCoordinate(coordinate)

지정된 coordinate 을 경로에 추가합니다.

removeCoordinate 와 path 를참조하십시오 .


void removeCoordinate(coordinate)

경로에서 coordinate 를 제거합니다. 동일한 좌표의 인스턴스가 여러 개 있는 경우, 마지막에 추가된 인스턴스가 제거됩니다.

coordinate 이 경로에 없는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

addCoordinate 및 path도 참조 하세요.


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