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::NoDirection | 0 | 지시 텍스트와 관련된 방향이 없습니다. |
QGeoManeuver::DirectionForward | 1 | 이 지침은 이동 방향을 변경할 필요가 없음을 나타냅니다. |
QGeoManeuver::DirectionBearRight | 2 | 이 지시어는 진행 방향이 오른쪽으로 향해야 함을 나타냅니다. |
QGeoManeuver::DirectionLightRight | 3 | 이 지시문은 오른쪽으로 가볍게 방향을 틀어야 함을 나타냅니다. |
QGeoManeuver::DirectionRight | 4 | 이 지시는 오른쪽으로 회전해야 함을 나타냅니다. |
QGeoManeuver::DirectionHardRight | 5 | 이 지시는 오른쪽으로 급격하게 회전해야 함을 나타냅니다. |
QGeoManeuver::DirectionUTurnRight | 6 | 이 지시는 오른쪽으로 유턴해야 함을 나타냅니다. |
QGeoManeuver::DirectionUTurnLeft | 7 | 이 지시는 왼쪽으로 U턴해야 함을 나타냅니다. |
QGeoManeuver::DirectionHardLeft | 8 | 이 지시는 왼쪽으로 급격하게 회전해야 함을 나타냅니다. |
QGeoManeuver::DirectionLeft | 9 | 이 지시는 왼쪽으로 회전해야 함을 나타냅니다. |
QGeoManeuver::DirectionLightLeft | 10 | 이 표시는 왼쪽으로 약간 회전해야 함을 나타냅니다. |
QGeoManeuver::DirectionBearLeft | 11 | 이 지시는 주행 방향을 왼쪽으로 유지해야 함을 나타냅니다. |
속성 문서
[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.