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() | |
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도 참조하세요 .
멤버 유형 문서
열거형 QGeoRouteRequest::FeatureType
플래그 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 조합을 저장합니다.
열거형 QGeoRouteRequest::FeatureWeight
플래그 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 조합을 저장합니다.
열거형 QGeoRouteRequest::ManeuverDetail
플래그 QGeoRouteRequest::ManeuverDetails
경로에 포함되어야 하는 기동 정보의 양을 정의합니다.
상수 | 값 | 설명 |
---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | 경로에 기동을 포함하지 않습니다. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | 기본 기동은 경로에 포함됩니다. 여기에는 QGeoManeuver::instructionText()가 포함됩니다. |
ManeuverDetails 유형은 QFlags<ManeuverDetail>에 대한 typedef입니다. ManeuverDetail 값의 OR 조합을 저장합니다.
열거형 QGeoRouteRequest::RouteOptimization
플래그 QGeoRouteRequest::RouteOptimizations
경로 계획에 적용되는 최적화 유형을 정의합니다.
Constant | 값 | 설명 |
---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | 여정 길이를 최소화합니다. |
QGeoRouteRequest::FastestRoute | 0x0002 | 여정의 이동 시간을 최소화합니다. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | 여정 비용을 최소화합니다. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | 여정의 경치 잠재력을 최대화합니다. |
RouteOptimizations 유형은 QFlags<RouteOptimization>에 대한 타입 정의입니다. RouteOptimization 값의 OR 조합을 저장합니다.
열거형 QGeoRouteRequest::SegmentDetail
플래그 QGeoRouteRequest::SegmentDetails
경로에 포함되어야 하는 경로 세그먼트 정보의 양을 정의합니다.
Constant | 값 | 설명 |
---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | 경로에 세그먼트 데이터가 포함되지 않아야 합니다. 이 수준의 세그먼트 세부 정보로 요청된 경로는 이전 및 다음 QGeoManeuver 인스턴스의 위치 사이의 직선으로 QGeoRouteSegment::path()를 초기화합니다. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | 기본 세그먼트 데이터가 경로에 포함됩니다. 여기에는 QGeoRouteSegment::path()가 포함됩니다. |
SegmentDetails 유형은 QFlags<SegmentDetail>에 대한 타입 정의입니다. SegmentDetail 값의 OR 조합을 저장합니다.
열거형 QGeoRouteRequest::TravelMode
플래그 QGeoRouteRequest::TravelModes
경로에 사용할 이동 모드를 정의합니다.
Constant | 값 | 설명 |
---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | 자동차를 운전하는 사람에게 경로가 최적화됩니다. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | 걷는 사람에게 최적화된 경로입니다. |
QGeoRouteRequest::BicycleTravel | 0x0004 | 자전거를 타는 사람에게 최적화된 경로가 생성됩니다. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | 대중교통을 이용하는 사용자에게 최적화된 경로입니다. |
QGeoRouteRequest::TruckTravel | 0x0010 | 트럭을 운전하는 사람에게 최적화된 경로가 표시됩니다. |
TravelModes 유형은 QFlags<TravelMode>에 대한 타입 정의입니다. 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 의 콘텐츠로 경로 요청 객체를 구성합니다.
[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 이 동일한지 여부를 반환합니다.
© 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.