QGeoRouteRequest Class
QGeoRouteRequest 클래스는 경로 정보 요청을 정의하는 매개변수와 제한 사항을 나타냅니다. 더 보기...
| Header: | #include <QGeoRouteRequest> |
| qmake: | QT += location |
공개 유형
| enum | FeatureType { NoFeature, TollFeature, HighwayFeature, PublicTransitFeature, FerryFeature, …, TrafficFeature } |
| flags | FeatureTypes |
| enum | FeatureWeight { NeutralFeatureWeight, PreferFeatureWeight, RequireFeatureWeight, AvoidFeatureWeight, DisallowFeatureWeight } |
| flags | FeatureWeights |
| enum | ManeuverDetail { NoManeuvers, BasicManeuvers } |
| flags | ManeuverDetails |
| enum | RouteOptimization { ShortestRoute, FastestRoute, MostEconomicRoute, MostScenicRoute } |
| flags | RouteOptimizations |
| enum | SegmentDetail { NoSegmentData, BasicSegmentData } |
| flags | SegmentDetails |
| enum | TravelMode { CarTravel, PedestrianTravel, BicycleTravel, PublicTransitTravel, TruckTravel } |
| flags | TravelModes |
공개 함수
| QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>()) | |
| QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination) | |
| QGeoRouteRequest(const QGeoRouteRequest &other) | |
| QGeoRouteRequest(QGeoRouteRequest &&other) | |
| ~QGeoRouteRequest() | |
| QDateTime | departureTime() const |
| QList<QGeoRectangle> | excludeAreas() const |
| QList<QGeoRouteRequest::FeatureType> | featureTypes() const |
| QGeoRouteRequest::FeatureWeight | featureWeight(QGeoRouteRequest::FeatureType featureType) const |
| QGeoRouteRequest::ManeuverDetail | maneuverDetail() const |
| int | numberAlternativeRoutes() const |
| QGeoRouteRequest::RouteOptimizations | routeOptimization() const |
| QGeoRouteRequest::SegmentDetail | segmentDetail() const |
| void | setDepartureTime(const QDateTime &departureTime) |
| void | setExcludeAreas(const QList<QGeoRectangle> &areas) |
| void | setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight) |
| void | setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail) |
| void | setNumberAlternativeRoutes(int alternatives) |
| void | setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization) |
| void | setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail) |
| void | setTravelModes(QGeoRouteRequest::TravelModes travelModes) |
| void | setWaypoints(const QList<QGeoCoordinate> &waypoints) |
| QGeoRouteRequest::TravelModes | travelModes() const |
| QList<QGeoCoordinate> | waypoints() const |
| QGeoRouteRequest & | operator=(const QGeoRouteRequest &other) |
관련 비멤버
| bool | operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
| bool | operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
상세 설명
QGeoRouteRequest 인스턴스의 기본 상태는 주어진 경유지를 포함하는 자동차로 이동 시 가장 빠른 경로를 설명하는 기본 경로 세그먼트 및 내비게이션 조작에 대한 요청을 생성합니다.
경로 정보 제공업체에 따라 지원되는 기능에 상당한 차이가 있을 수 있으며, 동일한 제공업체라도 다른 권한 수준이 사용될 경우 지원되는 기능에 차이가 있을 수 있습니다.
QGeoRoutingManager 에는 현재 제공업체 및 인증 수준에서 지원되는 기능을 확인하는 데 사용할 수 있는 여러 함수가 있습니다.
QGeoRoutingManager도 참조하십시오 .
멤버 유형 설명서
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
경로 계획에 중요한 특징을 정의합니다.
이 값들은 경로 내 포함 여부( QGeoRouteRequest::FeatureWeight )를 결정하는 데 사용됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | QGeoRoutingManager::supportedFeatureTypes()에서 경로 계획 시 어떤 지형 요소도 고려하지 않을 것임을 나타내는 데 사용됩니다. |
QGeoRouteRequest::TollFeature | 0x00000001 | 경로를 계획할 때 유료 도로를 고려합니다. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | 경로를 계획할 때 고속도로를 고려합니다. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | 경로를 계획할 때 대중교통을 고려합니다. |
QGeoRouteRequest::FerryFeature | 0x00000008 | 경로를 계획할 때 페리를 고려합니다. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | 경로 계획 시 터널을 고려합니다. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | 경로를 계획할 때 비포장 도로를 고려하십시오. |
QGeoRouteRequest::ParksFeature | 0x00000040 | 경로를 계획할 때 공원을 고려하십시오. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | 경로를 계획할 때 전용 차로를 고려하십시오. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | 경로를 계획할 때는 현재 교통 상황을 고려하십시오. QtLocation 5.10부터 |
FeatureTypes 유형은 QFlags<FeatureType>에 대한 typedef입니다. 이 유형은 FeatureType 값들의 OR 조합을 저장합니다.
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
경로 계획 시 피처에 할당할 가중치를 정의합니다.
이 값들은 QGeoRouteRequest::Feature와 함께 사용되어 해당 특징이 경로의 일부로 포함되어야 하는지 여부를 결정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | 특징의 유무는 경로 계획에 영향을 미치지 않습니다. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | 이 피처를 포함하는 경로는 포함하지 않는 경로보다 우선적으로 고려됩니다. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | 해당 특징이 포함된 경로만 고려되며, 그렇지 않은 경우 경로가 반환되지 않습니다. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | 해당 특징이 포함되지 않은 경로가 포함된 경로보다 우선적으로 선택됩니다. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | 해당 특징이 포함되지 않은 경로만 고려되며, 그렇지 않은 경우 경로가 반환되지 않습니다. |
FeatureWeights 유형은 QFlags<FeatureWeight>에 대한 typedef입니다. 이 유형은 FeatureWeight 값들의 OR 조합을 저장합니다.
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
경로에 포함되어야 할 기동 정보의 양을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | 경로에 기동 정보를 포함하지 않아야 합니다. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | 기본 기동이 경로에 포함됩니다. 여기에는 ' QGeoManeuver::instructionText()'가 포함됩니다. |
ManeuverDetails 유형은 QFlags<ManeuverDetail>에 대한 typedef입니다. 이 유형은 ManeuverDetail 값들의 OR 조합을 저장합니다.
enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations
경로 계획에 적용되는 최적화 유형을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | 이동 거리를 최소화합니다. |
QGeoRouteRequest::FastestRoute | 0x0002 | 여행 시간을 최소화합니다. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | 여행 비용을 최소화하십시오. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | 여행의 경관적 잠재력을 극대화하십시오. |
RouteOptimizations 유형은 QFlags<RouteOptimization>에 대한 typedef입니다. 이 유형은 RouteOptimization 값들의 OR 조합을 저장합니다.
enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails
경로에 포함될 경로 구간 정보의 양을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | 경로에 세그먼트 데이터가 포함되어서는 안 됩니다. 이 수준의 세그먼트 세부 정보로 요청된 경로는 QGeoRouteSegment::path()를 이전 및 다음 QGeoManeuver 인스턴스의 위치 사이를 연결하는 직선으로 초기화합니다. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | 기본 세그먼트 데이터가 경로에 포함됩니다. 여기에는 QGeoRouteSegment::path()이 포함됩니다. |
SegmentDetails 유형은 QFlags<SegmentDetail>에 대한 typedef입니다. 이 유형은 SegmentDetail 값들의 OR 조합을 저장합니다.
enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes
경로에 사용할 이동 수단을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | 이 경로는 자동차를 운전하는 사람을 기준으로 최적화됩니다. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | 경로는 도보로 이동하는 사람을 기준으로 최적화됩니다. |
QGeoRouteRequest::BicycleTravel | 0x0004 | 이 경로는 자전거를 타는 사람을 기준으로 최적화됩니다. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | 이 경로는 대중교통을 이용하는 사람을 위해 최적화됩니다. |
QGeoRouteRequest::TruckTravel | 0x0010 | 이 경로는 트럭을 운전하는 사용자에게 최적화됩니다. |
TravelModes 유형은 QFlags<TravelMode>에 대한 typedef입니다. 이 유형은 TravelMode 값들의 OR 조합을 저장합니다.
멤버 함수 설명서
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
waypoints 좌표를 경유하는 경로를 계산하기 위한 요청을 생성합니다.
경로는 ` waypoints `에 포함된 객체들을 순서대로 통과합니다.
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
origin 와 destination 사이의 경로를 계산하기 위한 요청을 생성합니다.
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
other 의 내용을 바탕으로 경로 요청 객체를 생성합니다.
[constexpr noexcept default] QGeoRouteRequest::QGeoRouteRequest(QGeoRouteRequest &&other)
QGeoRouteRequest 의 인스턴스를 move-construct 방식으로 생성합니다.
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
요청을 삭제합니다.
QDateTime QGeoRouteRequest::departureTime() const
요청에 포함된 출발 시간을 반환합니다.
setDepartureTime()도 참조하십시오 .
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
경로가 통과해서는 안 되는 구역을 반환합니다.
setExcludeAreas()도 참조하십시오 .
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
경로 계획 시 고려될 특징들의 목록을 반환합니다. 가중치가 NeutralFeatureWeight 인 특징은 반환되지 않습니다.
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
경로 계획 시 ‘ featureType ’에 할당된 가중치를 반환합니다.
featureType 에 대해 피처 가중치가 지정되지 않은 경우, NeutralFeatureWeight 가 반환됩니다.
setFeatureWeight()도 참조하십시오 .
QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const
경로 설정 기동을 표현하는 데 사용될 세부 수준을 반환합니다.
setManeuverDetail()도 참조하십시오 .
int QGeoRouteRequest::numberAlternativeRoutes() const
요청될 대체 경로의 수를 반환합니다.
setNumberAlternativeRoutes()도 참조하십시오 .
QGeoRouteRequest::RouteOptimizations QGeoRouteRequest::routeOptimization() const
이 요청에서 경로 계획 시 사용해야 한다고 지정한 최적화 기준을 반환합니다.
setRouteOptimization()도 참조하십시오 .
QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const
라우팅 세그먼트를 표현하는 데 사용될 상세 수준을 반환합니다.
setSegmentDetail()도 참조하십시오 .
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
경로 계산 시 출발 시간 departureTime 을 설정합니다. 이 정보는 백엔드에서, 예를 들어 출퇴근 시간대의 교통 체증을 피하는 등 더 빠른 경로를 계산하는 데 활용될 수 있습니다.
기본값은 유효하지 않은 QDateTime 입니다.
departureTime()도 참조하십시오 .
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
areas 를 경로가 통과해서는 안 되는 제외 구역으로 설정합니다.
excludeAreas()도 참조하십시오 .
void QGeoRouteRequest::setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)
경로 계획 과정에서 featureType 특징에 featureWeight 의 가중치를 할당합니다.
기본적으로 모든 특징에는 가중치 NeutralFeatureWeight 가 할당됩니다.
QGeoRouteRequest::NoFeature 에 가중치를 할당할 수는 없습니다.
featureWeight()도 참조하십시오 .
void QGeoRouteRequest::setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)
maneuverDetail 에 경로 설정 기동을 표시할 때 사용할 세부 수준을 설정합니다.
기본값은 QGeoRouteRequest::BasicManeuvers 입니다.
maneuverDetail()도 참조하십시오 .
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
alternatives 에 요청할 대체 경로의 수를 설정합니다. alternatives 가 음수인 경우, 대체 경로의 수는 0으로 설정됩니다.
기본값은 0입니다.
numberAlternativeRoutes()도 참조하십시오 .
void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
optimization 로 가는 경로를 계획할 때 사용할 최적화 기준을 설정합니다.
기본값은 QGeoRouteRequest::FastestRoute 입니다.
routeOptimization()도 참조하십시오 .
void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
segmentDetail 에 라우팅 세그먼트를 표현할 때 사용할 세부 수준을 설정합니다.
segmentDetail()도 참조하십시오 .
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
경로 계획 시 고려해야 할 이동 모드를 travelModes 로 설정합니다.
기본값은 QGeoRouteRequest::CarTravel 입니다.
travelModes()도 참조하십시오 .
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
waypoints 를 경로가 통과해야 할 경유지로 설정합니다.
경유지는 출발지에서 목적지 순으로 지정해야 합니다.
경유지가 두 개 이상의 좌표로 구성된 목록으로 설정될 때까지는 이 요청이 유효하지 않습니다.
waypoints()도 참조하십시오 .
QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const
이 요청에서 경로 계획 시 고려해야 할 이동 수단을 반환합니다.
setTravelModes()도 참조하십시오 .
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
경로가 통과하게 될 경유지를 반환합니다.
setWaypoints()도 참조하십시오 .
[noexcept] QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
이 경로 요청 객체에 ` other `를 할당한 다음, 이 경로 요청 객체에 대한 참조를 반환합니다.
관련 비회원
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
lhs 와 rhs 요청 경로가 서로 다른지 여부를 반환합니다.
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &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.