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::NoFeature0x00000000QGeoRoutingManager::supportedFeatureTypes()에서 경로를 계획할 때 어떤 기능도 고려하지 않음을 나타내기 위해 사용합니다.
QGeoRouteRequest::TollFeature0x00000001경로를 계획할 때 유료도로를 고려합니다.
QGeoRouteRequest::HighwayFeature0x00000002경로를 계획할 때 고속도로를 고려합니다.
QGeoRouteRequest::PublicTransitFeature0x00000004경로를 계획할 때 대중교통을 고려합니다.
QGeoRouteRequest::FerryFeature0x00000008경로를 계획할 때 페리를 고려합니다.
QGeoRouteRequest::TunnelFeature0x00000010경로를 계획할 때 터널을 고려합니다.
QGeoRouteRequest::DirtRoadFeature0x00000020경로를 계획할 때 비포장 도로를 고려합니다.
QGeoRouteRequest::ParksFeature0x00000040경로를 계획할 때 공원을 고려합니다.
QGeoRouteRequest::MotorPoolLaneFeature0x00000080경로를 계획할 때 자동차 전용 차선을 고려합니다.
QGeoRouteRequest::TrafficFeature0x00000100경로를 계획할 때 현재 교통 상황을 고려합니다. QtLocation 5.10 이후

FeatureTypes 유형은 QFlags<FeatureType>에 대한 typedef입니다. FeatureType 값의 OR 조합을 저장합니다.

열거형 QGeoRouteRequest::FeatureWeight
플래그 QGeoRouteRequest::FeatureWeights

경로를 계획하는 동안 피처와 연관시킬 가중치를 정의합니다.

이 값은 경로에 포함할지 여부를 결정하기 위해 QGeoRouteRequest::Feature와 함께 사용됩니다.

상수설명
QGeoRouteRequest::NeutralFeatureWeight0x00000000기능의 유무는 경로 계획에 영향을 미치지 않습니다.
QGeoRouteRequest::PreferFeatureWeight0x00000001기능이 포함된 경로가 포함되지 않은 경로보다 우선합니다.
QGeoRouteRequest::RequireFeatureWeight0x00000002기능이 포함된 경로만 고려되며, 그렇지 않으면 경로가 반환되지 않습니다.
QGeoRouteRequest::AvoidFeatureWeight0x00000004기능이 포함되지 않은 경로가 포함되는 경로보다 우선적으로 고려됩니다.
QGeoRouteRequest::DisallowFeatureWeight0x00000008기능을 포함하지 않는 경로만 고려되며, 그렇지 않으면 경로가 반환되지 않습니다.

FeatureWeights 유형은 QFlags<FeatureWeight>에 대한 typedef입니다. FeatureWeight 값의 OR 조합을 저장합니다.

열거형 QGeoRouteRequest::ManeuverDetail
플래그 QGeoRouteRequest::ManeuverDetails

경로에 포함되어야 하는 기동 정보의 양을 정의합니다.

상수설명
QGeoRouteRequest::NoManeuvers0x0000경로에 기동을 포함하지 않습니다.
QGeoRouteRequest::BasicManeuvers0x0001기본 기동은 경로에 포함됩니다. 여기에는 QGeoManeuver::instructionText()가 포함됩니다.

ManeuverDetails 유형은 QFlags<ManeuverDetail>에 대한 typedef입니다. ManeuverDetail 값의 OR 조합을 저장합니다.

열거형 QGeoRouteRequest::RouteOptimization
플래그 QGeoRouteRequest::RouteOptimizations

경로 계획에 적용되는 최적화 유형을 정의합니다.

Constant설명
QGeoRouteRequest::ShortestRoute0x0001여정 길이를 최소화합니다.
QGeoRouteRequest::FastestRoute0x0002여정의 이동 시간을 최소화합니다.
QGeoRouteRequest::MostEconomicRoute0x0004여정 비용을 최소화합니다.
QGeoRouteRequest::MostScenicRoute0x0008여정의 경치 잠재력을 최대화합니다.

RouteOptimizations 유형은 QFlags<RouteOptimization>에 대한 타입 정의입니다. RouteOptimization 값의 OR 조합을 저장합니다.

열거형 QGeoRouteRequest::SegmentDetail
플래그 QGeoRouteRequest::SegmentDetails

경로에 포함되어야 하는 경로 세그먼트 정보의 양을 정의합니다.

Constant설명
QGeoRouteRequest::NoSegmentData0x0000경로에 세그먼트 데이터가 포함되지 않아야 합니다. 이 수준의 세그먼트 세부 정보로 요청된 경로는 이전 및 다음 QGeoManeuver 인스턴스의 위치 사이의 직선으로 QGeoRouteSegment::path()를 초기화합니다.
QGeoRouteRequest::BasicSegmentData0x0001기본 세그먼트 데이터가 경로에 포함됩니다. 여기에는 QGeoRouteSegment::path()가 포함됩니다.

SegmentDetails 유형은 QFlags<SegmentDetail>에 대한 타입 정의입니다. SegmentDetail 값의 OR 조합을 저장합니다.

열거형 QGeoRouteRequest::TravelMode
플래그 QGeoRouteRequest::TravelModes

경로에 사용할 이동 모드를 정의합니다.

Constant설명
QGeoRouteRequest::CarTravel0x0001자동차를 운전하는 사람에게 경로가 최적화됩니다.
QGeoRouteRequest::PedestrianTravel0x0002걷는 사람에게 최적화된 경로입니다.
QGeoRouteRequest::BicycleTravel0x0004자전거를 타는 사람에게 최적화된 경로가 생성됩니다.
QGeoRouteRequest::PublicTransitTravel0x0008대중교통을 이용하는 사용자에게 최적화된 경로입니다.
QGeoRouteRequest::TruckTravel0x0010트럭을 운전하는 사람에게 최적화된 경로가 표시됩니다.

TravelModes 유형은 QFlags<TravelMode>에 대한 타입 정의입니다. TravelMode 값의 OR 조합을 저장합니다.

멤버 함수 문서

[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())

좌표 waypoints 를 통해 경로를 계산하는 요청을 작성합니다.

이 경로는 waypoints 의 객체를 순서대로 횡단합니다.

QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)

origindestination 사이의 경로를 계산하는 요청을 작성합니다.

[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)

경로 요청 lhsrhs 이 같지 않은지 여부를 반환합니다.

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

경로 요청 lhsrhs 이 동일한지 여부를 반환합니다.

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