route QML Value Type

경로 유형은 하나의 지리적 경로를 나타냅니다. 더 보기...

속성

• bounds : geoRectangle
• distance : real
• extendedAttributes : Object (since QtLocation 5.13)
• legIndex : int
• legs : list<route> (since QtLocation 5.12)
• overallRoute : Route
• path : list<coordinate>
• segments : list<routeSegment>
• travelTime : int

방법

• int segmentsCount()

상세 설명

경로 유형에는 경로의 길이, 예상 소요 시간, 지도상에 경로의 기본 이미지를 표시하는 데 필요한 정보 등 경로에 대한 개략적인 정보가 포함됩니다.

QGeoRoute 객체에는 경로의 각 구간을 더 상세하게 설명하는 routeSegment 객체 목록도 포함되어 있습니다.

경로 객체를 획득하는 주요 방법은 RouteModel 입니다.

예제

이 예제는 ListView 에서 경로의 주행 단계를 표시하는 방법을 보여줍니다:

import QtQuick
import QtPositioning
import QtLocation

RouteModel {
    id: routeModel
    // model initialization
}

ListView {
    id: listview
    anchors.fill: parent
    spacing: 10
    model: routeModel.status == RouteModel.Ready ? routeModel.get(0).segments : null
    visible: model ? true : false
    delegate: Row {
        width: parent.width
        spacing: 10
        property bool hasManeuver : modelData.maneuver && modelData.maneuver.valid
        visible: hasManeuver
        Text { text: (1 + index) + "." }
        Text { text: hasManeuver ? modelData.maneuver.instructionText : "" }
    }
}

속성 설명서

bounds : geoRectangle

전체 경로를 포함하는 바운딩 박스를 보관하는 읽기 전용 속성입니다.

distance : real

이 경로의 이동 거리를 미터 단위로 저장하는 읽기 전용 속성입니다.

extendedAttributes : Object [since QtLocation 5.13]

이 속성은 경로의 확장 속성을 포함하며 맵 형식입니다. 이러한 속성은 플러그인마다 다르며, 비어 있을 수도 있습니다.

지원되는 속성과 사용 방법에 대해서는 플러그인 설명서를 참조하십시오.

참고: QQmlPropertyMap 의 제한 사항으로 인해 QML에서 속성을 선언적으로 지정할 수 없으며, 속성 키와 값의 할당은 JavaScript를 통해서만 수행할 수 있습니다.

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

legIndex : int

포함된 경로의 QtLocation::route::legs 목록 내에서 해당 구간의 인덱스를 저장하는 읽기 전용 속성입니다. 이 경로가 전체 경로 내의 구간이 아닌 경우 인덱스는 -1입니다.

overallRoute도 참조하십시오 .

legs : list<route> [since QtLocation 5.12]

이 경로와 관련된 경로 구간을 반환합니다. 경로 구간은 인접한 두 웨이포인트 사이의 하위 경로를 말합니다. 백엔드에서 이 수준의 세부 정보를 지원하지 않는 경우, 결과가 비어 있을 수 있습니다.

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

overallRoute : Route

이 구간이 포함된 경로를 저장하는 읽기 전용 속성입니다.

path : list<coordinate>

이 경로의 지리적 좌표를 저장하는 읽기 전용 속성입니다. 좌표는 이 경로 구간을 따라 이동하는 사람이 통과하게 될 순서대로 나열됩니다.

개별 세그먼트에 접근하려면 표준 목록 액세서를 사용할 수 있습니다. 'path.length'는 객체의 개수를 나타내고, 'path[0부터 시작하는 인덱스]'는 해당 객체를 반환합니다.

QtPositioning::coordinate도 참조하십시오 .

segments : list<routeSegment>

이 경로의 ` routeSegment ` 객체 목록을 포함하는 읽기 전용 속성입니다.

개별 세그먼트에 접근하려면 표준 목록 액세서를 사용할 수 있습니다. 'segments.length'는 객체의 개수를 나타내며, 'segments[0부터 시작하는 인덱스]'는 실제 객체를 반환합니다.

routeSegment도 참조하십시오 .

travelTime : int

이 경로를 통과하는 데 소요될 것으로 예상되는 시간을 초 단위로 저장하는 읽기 전용 속성입니다.

메서드 문서

int segmentsCount()

경로의 세그먼트 수를 반환합니다.

routeSegment도 참조하십시오 .