이 페이지에서

routeManeuver QML Type

routeManeuver 유형은 두 routeSegment가 만나는 지점과 관련된 정보를 나타냅니다. 더 보기...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

속성

상세 설명

routeSegment 의 인스턴스는 라우팅 그래프의 간선으로 볼 수 있으며, routeManeuver 인스턴스는 그래프의 정점에 부착된 선택적 레이블로 간주할 수 있습니다.

routeManeuver 인스턴스에 포함된 가장 중요한 정보는 일반적으로 제공해야 할 텍스트 형태의 내비게이션과 이를 제공해야 할 위치이며, 이 정보들은 각각 instructionText 및 position 를 통해 접근할 수 있습니다.

예제

다음 QML 코드 조각은 경로 기동(route maneuver)에 대한 정보를 출력하는 방법을 보여줍니다:

import QtQuick
import QtPositioning
import QtLocation

Text {
    text: "Distance till next maneuver: " + routeManeuver.distanceToNextInstruction
          + " meters, estimated time: " + routeManeuver.timeToNextInstruction + " seconds."
}

속성 문서

direction : enumeration

routeManeuver 에 연결된 명령 텍스트와 관련된 방향의 변화를 설명합니다.

  • RouteManeuver.NoDirection - 지시문과 연관된 방향이 없습니다.
  • RouteManeuver.DirectionForward - 이 지시문은 진행 방향을 변경할 필요가 없음을 나타냅니다
  • RouteManeuver.DirectionBearRight - 주행 방향을 오른쪽으로 유지해야 함을 나타냅니다.
  • RouteManeuver.DirectionLightRight - 지시 사항에 따라 오른쪽으로 가볍게 회전해야 함
  • RouteManeuver.DirectionRight - 오른쪽으로 회전해야 함을 나타냅니다.
  • RouteManeuver.DirectionHardRight - 이 지시는 오른쪽으로 급격히 회전해야 함을 나타냅니다
  • RouteManeuver.DirectionUTurnRight - 이 지시는 오른쪽으로 유턴해야 함을 나타냅니다
  • RouteManeuver.DirectionUTurnLeft - 이 지시는 왼쪽으로 U턴해야 함을 나타냅니다
  • RouteManeuver.DirectionHardLeft - 이 지시는 왼쪽으로 급격히 회전해야 함을 나타냅니다
  • RouteManeuver.DirectionLeft - 이 지시는 왼쪽으로 회전해야 함을 나타냅니다
  • RouteManeuver.DirectionLightLeft - 이 지시는 왼쪽으로 가볍게 회전해야 함을 나타냅니다
  • RouteManeuver.DirectionBearLeft - 주행 방향을 왼쪽으로 유지해야 함을 나타내는 지시 사항입니다

distanceToNextInstruction : real

이 읽기 전용 속성은 관련 명령이 실행된 지점과 다음 명령이 실행되어야 할 지점 사이의 거리를 미터 단위로 저장합니다.

extendedAttributes : Object [since QtLocation 5.11]

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

어떤 속성이 지원되며 어떻게 사용해야 하는지에 대해서는 플러그인 문서를 참조하십시오.

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

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

instructionText : string

이 읽기 전용 속성은 텍스트 형태의 탐색 지침을 포함합니다.

position : coordinate

이 읽기 전용 속성은 instructionText 가 표시되어야 할 위치를 지정합니다.

timeToNextInstruction : int

이 읽기 전용 속성은 관련 명령어가 실행된 지점부터 다음 명령어가 실행되어야 할 지점까지 이동하는 데 소요될 것으로 예상되는 시간을 초 단위로 저장합니다.

valid : bool

이 읽기 전용 속성은 해당 기동이 유효한지 여부를 나타냅니다.

QGeoRouteSegment 인스턴스의 엔드포인트에 첨부해야 할 정보가 없는 경우, 무효 기동이 사용됩니다.

waypoint : coordinate

이 속성은 해당 기동과 관련된 웨이포인트를 저장합니다. 모든 기동에 웨이포인트가 있는 것은 아닙니다.

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