Map QML Type

현재 활성화된 map type 에 액세스합니다.

이 속성은 활성 map type 을 변경하도록 설정할 수 있습니다. 가능한 값은 supportedMapTypes 속성을 참조하세요.

mapType 을참조하세요 .

이 속성은 지도의 방위를 저장합니다. 기본값은 0입니다. 지도에 사용되는 플러그인이 방위를 지원하는 경우 이 값의 유효한 범위는 0에서 360 사이입니다. 맵에 사용된 플러그인이 방위를 지원하지 않는 경우 이 속성을 변경해도 효과가 없습니다.

이 속성은 QtLocation 5.9에 도입되었습니다.

이 속성은 매핑 뷰포트의 중심을 차지하는 좌표를 보유합니다. 잘못된 중심 좌표는 무시됩니다.

기본값은 임의의 유효한 좌표입니다.

이 속성은 맵 요소의 배경색을 보유합니다.

이 속성은 저작권 고지의 가시성을 유지합니다. 알림은 일반적으로 왼쪽 하단에 표시됩니다. 기본적으로 이 속성은 true 로 설정되어 있습니다.

이 읽기 전용 속성은 마지막으로 발생한 매핑 서비스 제공업체 오류를 보관합니다.

• Map.NoError - 오류가 발생하지 않았습니다.
• 맵 플러그인 속성이 설정되지 않았거나 플러그인과 연결된 매핑 관리자가 없습니다.
• Map.UnknownParameterError - 플러그인이 제공된 매개변수 중 하나를 인식하지 못했습니다.
• Map.MissingRequiredParameterError - 플러그인이 예상한 매개변수 중 하나를 찾지 못했습니다.
• Map.ConnectionError - 플러그인이 백엔드 서비스 또는 데이터베이스에 연결할 수 없습니다.

QGeoServiceProvider::Error 를참조하세요 .

이 읽기 전용 속성은 최신 매핑 공급자 오류의 텍스트 표시를 보유합니다. 오류가 발생하지 않으면 빈 문자열이 반환됩니다.

연관된 텍스트 표현이 없는 오류가 발생한 경우에도 빈 문자열이 반환될 수 있습니다.

QGeoServiceProvider::errorString()도 참조하세요 .

이 속성은 지도를 보는 데 사용되는 카메라의 시야를 도 단위로 보유합니다. 지도의 플러그인 속성이 설정되어 있지 않거나 플러그인이 매핑을 지원하지 않는 경우 이 값은 45도입니다.

이 값을 변경하면 카메라와 지도 사이의 거리도 암시적으로 변경되므로 기울기 각도가 0도일 때 결과 이미지는 이 속성에 사용된 모든 값에 대해 동일합니다.

이 매개 변수에 대한 자세한 내용은 시야 및 화각에 대한 Wikipedia 문서를 참조하세요.

이 속성은 QtLocation 5.9에 도입되었습니다.

minimumFieldOfView 및 maximumFieldOfView 을참조하세요 .

특정 순서 없이 모든 지도 항목의 목록을 반환합니다. 이러한 항목에는 유형 선언의 일부로 정적으로 선언된 항목과 동적 항목이 포함됩니다 (addMapItem, MapItemView).

addMapItem, removeMapItem, clearMapItems 를참조하세요 .

이 속성은 맵이 성공적으로 초기화되어 사용할 준비가 되었는지 여부를 보유합니다. fromCoordinate 및 toCoordinate 과 같은 일부 메서드는 맵이 준비되기 전에는 작동하지 않습니다. Map 의 아키텍처로 인해 모든 것이 예상대로 작동하는지 확인하기 위해 Component.onCompleted 대신 이 속성에 대해 방출되는 신호를 사용하는 것이 좋습니다.

이 속성은 맵에 유효한 최대 시야각을 도 단위로 보유합니다.

사용된 plugin 의 최소 기울기 시야각이 이 속성의 상한입니다. plugin 속성이 설정되지 않았거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 179 입니다.

이 속성은 QtLocation 5.9에 도입되었습니다.

fieldOfView 및 minimumFieldOfView 을참조하십시오 .

이 속성은 맵에 유효한 최대 기울기를 도 단위로 저장합니다.

사용된 plugin 에 정의된 최대 기울기가 이 속성의 상한입니다. plugin 속성이 설정되지 않았거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 89.5 입니다.

QtLocation 5.12부터 플러그인은 현재 줌 레벨에 따라 이 값을 추가로 제한할 수 있습니다.

이 속성은 QtLocation 5.9에서 도입되었습니다.

tilt 및 minimumTilt 을참조하십시오 .

이 속성은 맵에 유효한 최대 줌 레벨을 보유합니다.

최대 확대/축소 수준은 사용된 plugin 에 의해 정의됩니다. plugin 속성이 설정되지 않았거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 30 입니다.

이 속성은 맵에 유효한 최소 시야각을 도 단위로 보유합니다.

사용된 plugin 의 최소 기울기 시야각은 이 속성의 하한입니다. plugin 속성이 설정되지 않았거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 1 입니다.

이 속성은 QtLocation 5.9에 도입되었습니다.

fieldOfView 및 maximumFieldOfView 을참조하십시오 .

이 속성은 맵에 유효한 최소 기울기를 도 단위로 저장합니다.

사용된 plugin 에 정의된 최소 기울기는 이 속성의 하한입니다. plugin 속성이 설정되어 있지 않거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 0 입니다.

QtLocation 5.12부터 플러그인은 현재 줌 레벨에 따라 이 값을 추가로 제한할 수 있습니다.

이 속성은 QtLocation 5.9에서 도입되었습니다.

tilt 및 maximumTilt 을참조하십시오 .

이 속성은 맵에 유효한 최소 줌 레벨을 보유합니다.

사용된 plugin 에 정의된 최소 줌 레벨이 이 속성의 하한입니다. 그러나 반환되는 값은 캔버스 크기에 따라 달라지며, 사용자가 지정한 값보다 높거나 사용된 플러그인에 정의된 최소 줌 수준보다 높을 수 있으므로 어느 차원에서도 맵이 뷰포트보다 작아지는 것을 방지할 수 있습니다.

plugin 속성이 설정되지 않았거나 플러그인이 매핑을 지원하지 않는 경우 이 속성은 0 입니다.

이 속성은 매핑 기능을 제공하는 플러그인을 보유합니다.

이 속성은 일회성 속성입니다. 맵에 플러그인이 연결되면 플러그인을 수정하려고 시도한 모든 시도는 무시됩니다.

이 읽기 전용 속성에는 이 맵에서 지원하는 map types 집합이 저장됩니다.

activeMapType 를참조하세요 .

이 속성은 맵의 기울기를 도 단위로 저장합니다. 기본값은 0입니다. 이 값의 유효한 범위는 [ minimumTilt, maximumTilt ]입니다. 맵에 사용된 플러그인이 기울기를 지원하지 않는 경우 이 속성을 변경해도 효과가 없습니다.

이 속성은 QtLocation 5.9에 도입되었습니다.

minimumTilt 및 maximumTilt 을참조하십시오 .

이 속성은 맵 QML 요소 내부의 표시 영역을 보유합니다. 좌표가 Map 요소에 상대적인 직사각형입니다. 그 크기는 Map 요소의 크기에 고정됩니다. 가시 영역이 null이면 맵 전체가 표시됨을 의미합니다.

이 속성은 맵의 뷰포트를 차지하는 영역을 보유합니다. 카메라는 도형의 중앙에 위치하며, 전체 도형이 화면에 표시될 수 있도록 가능한 가장 큰 통합 줌 레벨로 배치됩니다. 이는 설정 직후 이 속성을 다시 읽으면 반환된 영역이 설정된 영역과 같거나 더 크다는 것을 의미합니다.

이 속성을 설정하면 맵의 center 및 zoomLevel 이 암시적으로 변경됩니다. 해당 속성에 이전에 설정된 값은 모두 재정의됩니다.

이 속성은 맵의 확대/축소 수준을 보유합니다.

줌 레벨의 값이 클수록 더 자세한 정보를 제공합니다. 확대/축소 수준은 항상 음수가 아닙니다. 기본값은 8.0입니다. 사용 중인 플러그인에 따라 타일을 사용할 수 있는 범위를 나타내는 [minimumZoomLevel, maximumZoomLevel] 범위를 벗어난 값이 허용되거나 제한될 수 있습니다.

이 신호는 사용자가 저작권 고지에서 link 을 클릭하면 발생합니다. 애플리케이션은 브라우저에서 링크를 열거나 사용자에게 해당 콘텐츠를 표시해야 합니다.

지정된 item 을 맵에 추가합니다(예: MapQuickItem, MapCircle). 객체가 이미 맵에 있는 경우 다시 추가되지 않습니다.

예를 들어 현재 위치를 나타내는 MapCircle 이 있는 경우를 생각해 보겠습니다:

import QtQuick
import QtPositioning
import QtLocation

PositionSource {
    id: positionSource
}

Map {
    id: map
    property MapCircle circle

    Component.onCompleted: {
        circle = Qt.createQmlObject('import QtLocation; MapCircle {}', page)
        circle.center = positionSource.position.coordinate
        circle.radius = 5000.0
        circle.color = 'green'
        circle.border.width = 3
        map.addMapItem(circle)
    }
}

mapItems, removeMapItem, clearMapItems 를참조하세요 .

주어진 itemGroup 에 포함된 맵 항목을 맵에 추가합니다(예: MapQuickItem, MapCircle).

MapItemGroup 및 removeMapItemGroup도 참조 하세요.

itemView 을 맵에 추가합니다.

MapItemView 및 removeMapItemView도 참조 하세요.

coordinate 을 point 으로 정렬합니다. 이 메서드는 center qml 속성에서 제공하는 기능을 효과적으로 확장하여 좌표를 지도 요소의 중심이 아닌 다른 지점에 정렬할 수 있도록 합니다. 이는 장면의 중심(예: 커서)을 맵의 중앙에 정확히 배치하지 않으려는 애플리케이션에 유용합니다.

지도가 기울어져 있고 coordinate 가 카메라 뒤에 있거나 지도가 준비되지 않은 경우( mapReady 참조 ) 이 메서드를 호출해도 아무런 효과가 없습니다.

Qt 5.10에서 이 API의 릴리스는 기술 프리뷰입니다.

center 를참조하세요 .

현재 선택된 플러그인에서 수집한 지도 데이터를 지웁니다.

plugin도 참조 하세요.

지도에서 모든 항목과 항목 그룹을 제거합니다.

mapItems, addMapItem, removeMapItem, addMapItemGroup, removeMapItemGroup 도참조하세요 .

뷰포트를 특정 지리적 모양에 맞춥니다 geoShape. margins 은 화면 픽셀 단위입니다.

visibleRegion 를참조하세요 .

인수가 제공되지 않으면 현재 뷰포트를 모든 맵 항목의 경계에 맞춥니다. 카메라는 맵 항목의 중앙에 위치하며, 모든 맵 항목이 화면에 표시될 수 있도록 가능한 가장 큰 통합 줌 레벨로 배치됩니다. items 을 제공하면 현재 뷰포트를 지정된 맵 항목의 경계에만 맞춥니다.

fitViewportToVisibleMapItems 를참조하십시오 .

현재 뷰포트를 보이는 모든 지도 항목의 경계에 맞춥니다. 카메라는 지도 항목의 중앙에 위치하며, 모든 지도 항목이 화면에 표시될 수 있도록 가능한 가장 큰 통합 줌 레벨로 배치됩니다.

fitViewportToMapItems 를참조하세요 .

coordinate 에 해당하는 지도 항목을 기준으로 한 위치를 반환합니다.

clipToViewPort 이 true 이거나 제공되지 않은 경우, coordinate 이 현재 뷰포트 내에 있지 않으면 잘못된 QPointF 을 반환합니다.

맵을 x축을 따라 dx 픽셀만큼, y축을 따라 dy 픽셀만큼 패닝하기 시작합니다.

dx 값이 양수이면 맵을 오른쪽으로, 음수이면 왼쪽으로 이동합니다. dy 의 양수 값은 맵을 아래로, 음수 값은 위로 이동합니다.

패닝하는 동안 center 및 zoomLevel 이 변경될 수 있습니다.

이 유휴 기간 동안 지도를 미리 가져올 수 있는 선택적 힌트

지정된 item 을 맵에서 제거합니다(예: MapQuickItem, MapCircle). MapItem이 존재하지 않거나 이전에 맵에 추가되지 않은 경우 이 메서드는 아무 작업도 수행하지 않습니다.

mapItems, addMapItem, clearMapItems 를참조하세요 .

itemGroup 및 여기에 포함된 항목을 맵에서 제거합니다.

MapItemGroup 및 addMapItemGroup도 참조 하세요.

itemView 및 에 의해 인스턴스화된 항목을 맵에서 제거합니다.

MapItemView 및 addMapItemView도 참조 하세요.

지도의 방위를 bearing 로 설정하고 coordinate 를 중심으로 회전합니다. 맵에 사용된 플러그인이 방위를 지원하는 경우 bearing 의 유효한 범위는 0에서 360 사이입니다. 지도에 사용된 플러그인이 방위를 지원하지 않거나 지도가 기울어져 coordinate 이 카메라 뒤에 있는 경우 또는 지도가 준비되지 않은 경우( mapReady 참조 ) 이 메서드를 호출해도 아무런 효과가 없습니다.

이 API는 Qt 5.10에서 기술 프리뷰 버전으로 출시되었습니다.

지도 항목을 기준으로 position 에 해당하는 좌표를 반환합니다.

clipToViewPort 이 true 이거나, position 이 현재 뷰포트 내에 있지 않은 경우 잘못된 좌표를 반환합니다.