route QML Value Type

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

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

속성

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에서 속성을 선언적으로 지정할 수 없으므로 속성 키와 값의 할당은 자바스크립트로만 수행할 수 있습니다.

이 속성은 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도 참조 하세요.

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