이 페이지에서

QGeoManeuver Class

QGeoManeuver 클래스는 두 개의 QGeoRouteSegment가 만나는 지점과 관련된 정보를 나타냅니다. 더 보기...

Header: #include <QGeoManeuver>
qmake: QT += location

공개 유형

enum InstructionDirection { NoDirection, DirectionForward, DirectionBearRight, DirectionLightRight, DirectionRight, …, DirectionBearLeft }

속성

공개 기능

QGeoManeuver()
QGeoManeuver(const QGeoManeuver &other)
QGeoManeuver(QGeoManeuver &&other)
~QGeoManeuver()
QGeoManeuver::InstructionDirection direction() const
qreal distanceToNextInstruction() const
QVariantMap extendedAttributes() const
QString instructionText() const
bool isValid() const
QGeoCoordinate position() const
int timeToNextInstruction() const
QGeoCoordinate waypoint() const
QGeoManeuver &operator=(const QGeoManeuver &other)
bool operator!=(const QGeoManeuver &lhs, const QGeoManeuver &rhs)
bool operator==(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

상세 설명

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

QGeoManeuver 인스턴스에서 가장 흥미로운 정보는 일반적으로 제공해야 할 텍스트 내비게이션과 이를 제공해야 할 위치이며, 각각 instructionText() 및 position()를 통해 액세스할 수 있습니다.

또한 waypoint()이 유효한 QGeoCoordinate 를 반환하는지 확인하여 경로 웨이포인트를 통과했는지 여부를 판단할 수도 있습니다.

멤버 유형 문서

enum QGeoManeuver::InstructionDirection

QGeoManaeuver와 연관된 지시 텍스트와 관련된 방향 변화를 설명합니다.

상수값설명
QGeoManeuver::NoDirection0지시 텍스트와 관련된 방향이 없습니다.
QGeoManeuver::DirectionForward1이 지침은 이동 방향을 변경할 필요가 없음을 나타냅니다.
QGeoManeuver::DirectionBearRight2이 지시어는 진행 방향이 오른쪽으로 향해야 함을 나타냅니다.
QGeoManeuver::DirectionLightRight3이 지시문은 오른쪽으로 가볍게 방향을 틀어야 함을 나타냅니다.
QGeoManeuver::DirectionRight4이 지시는 오른쪽으로 회전해야 함을 나타냅니다.
QGeoManeuver::DirectionHardRight5이 지시는 오른쪽으로 급격하게 회전해야 함을 나타냅니다.
QGeoManeuver::DirectionUTurnRight6이 지시는 오른쪽으로 유턴해야 함을 나타냅니다.
QGeoManeuver::DirectionUTurnLeft7이 지시는 왼쪽으로 U턴해야 함을 나타냅니다.
QGeoManeuver::DirectionHardLeft8이 지시는 왼쪽으로 급격하게 회전해야 함을 나타냅니다.
QGeoManeuver::DirectionLeft9이 지시는 왼쪽으로 회전해야 함을 나타냅니다.
QGeoManeuver::DirectionLightLeft10이 표시는 왼쪽으로 약간 회전해야 함을 나타냅니다.
QGeoManeuver::DirectionBearLeft11이 지시는 주행 방향을 왼쪽으로 유지해야 함을 나타냅니다.

속성 문서

[read-only] direction : const InstructionDirection

이 속성은 관련 명령어와 연관된 방향을 저장합니다.

액세스 함수:

QGeoManeuver::InstructionDirection direction() const

[read-only] distanceToNextInstruction : const qreal

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

액세스 함수:

qreal distanceToNextInstruction() const

[read-only, since QtLocation 5.11] extendedAttributes : const QVariantMap

이 속성은 이 기동과 관련된 확장 속성을 저장합니다.

이 열거형은 QtLocation 5.11에서 도입되었습니다.

액세스 함수:

QVariantMap extendedAttributes() const

[read-only] instructionText : const QString

이 속성에는 텍스트 형태의 탐색 지침이 포함됩니다.

액세스 기능:

QString instructionText() const

[read-only] position : const QGeoCoordinate

이 속성은 ‘ instructionText ’이 표시되어야 할 위치를 지정합니다.

액세스 함수:

QGeoCoordinate position() const

[read-only] timeToNextInstruction : const int

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

액세스 함수:

int timeToNextInstruction() const

[read-only] valid : const bool

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

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

액세스 함수:

bool isValid() const

[read-only] waypoint : const QGeoCoordinate

이 속성은 이 기동과 관련된 웨이포인트를 저장합니다.

이 기동에 연결된 웨이포인트가 없는 경우, 이 속성은 무효한 QGeoCoordinate 값을 가집니다.

액세스 함수:

QGeoCoordinate waypoint() const

멤버 함수 설명서

QGeoManeuver::QGeoManeuver()

유효하지 않은 기동 객체를 생성합니다.

setPosition(), setInstructionText(), setDirection(), setTimeToNextInstruction(), setDistanceToNextInstruction() 또는 setWaypoint() 중 하나가 호출될 때까지 이 기동은 유효하지 않은 상태로 유지됩니다.

[noexcept] QGeoManeuver::QGeoManeuver(const QGeoManeuver &other)

other 의 내용을 기반으로 기동 객체를 생성합니다.

[constexpr noexcept default] QGeoManeuver::QGeoManeuver(QGeoManeuver &&other)

QGeoManeuver 의 인스턴스를 생성합니다.

[noexcept] QGeoManeuver::~QGeoManeuver()

이 기동 객체를 파괴합니다.

QGeoManeuver &QGeoManeuver::operator=(const QGeoManeuver &other)

이 기동 객체에 ` other `을 할당한 다음, 이 기동 객체에 대한 참조를 반환합니다.

관련 비회원

[noexcept] bool operator!=(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

lhs 기동이 rhs 와 같지 않은지 여부를 반환합니다.

[noexcept] bool operator==(const QGeoManeuver &lhs, const QGeoManeuver &rhs)

lhs 기동이 rhs 와 동일한지 여부를 반환합니다.

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