Класс QGeoRouteRequest
Класс QGeoRouteRequest представляет параметры и ограничения, которые определяют запрос на маршрутную информацию. Подробнее...
| Заголовок: | #include <QGeoRouteRequest> |
| qmake: | QT += location |
| С тех пор: | Qt 5.6 |
Типы общедоступных
| перечисление | FeatureType { НетОсобенности, ПлатныйОбъект, Автомагистраль, ОбщественныйТранспорт, ..., ЛентообразныйОбъект } |
| флаги | FeatureTypes |
| перечисление | FeatureWeight { НейтральныйВесОсобенности, ПредпочтительныйВесОсобенности, ТребуемыйВесОсобенности, ИзбегатьВесОсобенности, ЗапрещенныйВесОсобенности } |
| флаги | FeatureWeights |
| перечисление | ManeuverDetail { НетМаневров, ОсновныеМаневры } |
| флаги | ManeuverDetails |
| перечисление | RouteOptimization { СамыйКороткийМаршрут, СамыйБыстрыйМаршрут, СамыйЭкономичныйМаршрут, СамыйКрасивыйМаршрут } |
| флаги | RouteOptimizations |
| перечисление | SegmentDetail { НетДанныхОтрезка, ОсновныеДанныеОтрезка } |
| флаги | SegmentDetails |
| перечисление | TravelMode { Автомобиль, Пешеход, Велосипед, ОбщественныйТранспорт, Грузовик } |
| флаги | TravelModes |
Общедоступные функции
| QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate> ()) | |
| QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination) | |
| QGeoRouteRequest(const QGeoRouteRequest &other) | |
| ~QGeoRouteRequest() | |
| QList<QGeoRectangle> | excludeAreas() const |
| QList<FeatureType> | featureTypes() const |
| FeatureWeight | featureWeight(FeatureType featureType) const |
| ManeuverDetail | maneuverDetail() const |
| int | numberAlternativeRoutes() const |
| RouteOptimizations | routeOptimization() const |
| SegmentDetail | segmentDetail() const |
| void | setExcludeAreas(const QList<QGeoRectangle> &areas) |
| void | setFeatureWeight(FeatureType featureType, FeatureWeight featureWeight) |
Подробное описание
Класс QGeoRouteRequest представляет параметры и ограничения, которые определяют запрос на маршрутную информацию.
Стандартное состояние экземпляра QGeoRouteRequest приведет к запросу на основные данные отрезка маршрута и маневров навигации, описывающих самый быстрый автомобильный маршрут, охватывающий заданные контрольные точки.
В зависимости от поставщика маршрутной информации и уровня авторизации могут существенно отличаться поддерживаемые функции.
В классе QGeoRoutingManager есть несколько функций, которые можно использовать для проверки поддерживаемых функций с текущим поставщиком и уровнем авторизации.
См. также QGeoRoutingManager.
Документация типов членов
перечисление QGeoRouteRequest::FeatureTypeфлаги QGeoRouteRequest::FeatureTypes
Определяет особенность, важная для планирования маршрута.
Эти значения будут использоваться совместно с QGeoRouteRequest::FeatureWeight для определения того, должны ли они быть частью маршрута или нет.
END_OF_DOCUMENT_MARKER| Постоянная | Значение | Описание |
|---|---|---|
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 |
Учитывать полосы движения автопарка при планировании маршрута. |
Тип FeatureTypes является псевдонимом для QFlags<FeatureType>. Он хранит комбинацию значений 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>. Он хранит комбинацию значений FeatureWeight, объединённых операцией OR.
перечисление QGeoRouteRequest::ManeuverDetailфлаги QGeoRouteRequest::ManeuverDetails
Определяет объём информации о манёврах, которые должны быть включены в маршрут.
| Постоянная | Значение | Описание |
|---|---|---|
QGeoRouteRequest::NoManeuvers |
0x0000 |
Информация о манёврах не должна включаться в маршрут. |
QGeoRouteRequest::BasicManeuvers |
0x0001 |
В маршрут будут включены базовые манёвры. Это будет включать QGeoManeuver::instructionText(). |
Тип ManeuverDetails является псевдонимом для QFlags<ManeuverDetail>. Он хранит комбинацию значений ManeuverDetail, объединённых операцией OR.
перечисление QGeoRouteRequest::RouteOptimizationфлаги QGeoRouteRequest::RouteOptimizations
Определяет тип оптимизации, применяемой к планированию маршрута.
| Постоянная | Значение | Описание |
|---|---|---|
QGeoRouteRequest::ShortestRoute |
0x0001 |
Минимизировать длину поездки. |
QGeoRouteRequest::FastestRoute |
0x0002 |
Минимизировать время поездки. |
QGeoRouteRequest::MostEconomicRoute |
0x0004 |
Минимизировать стоимость поездки. |
QGeoRouteRequest::MostScenicRoute |
0x0008 |
Максимизировать живописность поездки. |
Тип RouteOptimizations является псевдонимом для QFlags<RouteOptimization>. Он хранит комбинацию значений RouteOptimization, объединённых операцией OR.
перечисление QGeoRouteRequest::SegmentDetailфлаги QGeoRouteRequest::SegmentDetails
Определяет объём информации о сегментах маршрута, которые должны быть включены в маршрут.
| Постоянная | Значение | Описание |
|---|---|---|
QGeoRouteRequest::NoSegmentData |
0x0000 |
Данные о сегментах не должны включаться в маршрут. Маршрут, запрошенный с этим уровнем детализации сегментов, инициализирует QGeoRouteSegment::path() как прямую линию между позициями предыдущих и последующих QGeoManeuver элементов. |
QGeoRouteRequest::BasicSegmentData |
0x0001 |
В маршрут будут включены базовые данные о сегментах. Это будет включать QGeoRouteSegment::path(). |
Тип SegmentDetails является псевдонимом для QFlags<SegmentDetail>. Он хранит комбинацию значений SegmentDetail, объединённых операцией OR.
перечисление QGeoRouteRequest::TravelModeфлаги QGeoRouteRequest::TravelModes
Определяет режимы передвижения, которые нужно использовать для маршрута.
| Постоянная | Значение | Описание |
|---|---|---|
QGeoRouteRequest::CarTravel |
0x0001 |
Маршрут будет оптимизирован для водителя автомобиля. |
QGeoRouteRequest::PedestrianTravel |
0x0002 |
Маршрут будет оптимизирован для пешехода. |
QGeoRouteRequest::BicycleTravel |
0x0004 |
Маршрут будет оптимизирован для велосипедиста. |
QGeoRouteRequest::PublicTransitTravel |
0x0008 |
Маршрут будет оптимизирован для пользователя общественного транспорта. |
QGeoRouteRequest::TruckTravel |
0x0010 |
Маршрут будет оптимизирован для водителя грузовика. |
Тип TravelModes является псевдонимом для QFlags<TravelMode>. Он хранит комбинацию значений TravelMode, объединённых операцией OR.
Документация по функциям-членам
QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate> ())
Создаёт запрос на вычисление маршрута через точки waypoints.
Маршрут будет проходить через объекты waypoints в указанном порядке.
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
Создаёт запрос на вычисление маршрута между origin и destination.
QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
Создаёт объект запроса маршрута на основе содержимого other.
QGeoRouteRequest::~QGeoRouteRequest()
Уничтожает запрос.
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
Возвращает области, через которые маршрут не должен проходить.
См. также setExcludeAreas().
QList<FeatureType> QGeoRouteRequest::featureTypes() const
Возвращает список объектов, которые будут учитываться при планировании маршрута. Объекты с весом NeutralFeatureWeight не будут возвращены.
FeatureWeight QGeoRouteRequest::featureWeight(FeatureType featureType) const
Возвращает вес, присвоенный featureType при планировании маршрута.
Если для featureType не указан вес, то будет возвращено значение NeutralFeatureWeight.
См. также setFeatureWeight().
ManeuverDetail QGeoRouteRequest::maneuverDetail() const
Возвращает уровень детализации, который будет использоваться в представлении маршрутных маневров.
См. также setManeuverDetail().
int QGeoRouteRequest::numberAlternativeRoutes() const
Возвращает количество альтернативных маршрутов, которые будут запрошены.
См. также setNumberAlternativeRoutes().
RouteOptimizations QGeoRouteRequest::routeOptimization() const
Возвращает критерии оптимизации, которые должны быть использованы при планировании маршрута.
См. также setRouteOptimization().
SegmentDetail QGeoRouteRequest::segmentDetail() const
Возвращает уровень детализации, который будет использоваться при представлении участков маршрута.
См. также setSegmentDetail().
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
Устанавливает areas как исключённые области, через которые маршрут не должен проходить.
См. также excludeAreas().
void QGeoRouteRequest::setFeatureWeight(FeatureType featureType, FeatureWeight featureWeight)
Назначает вес featureWeight для элемента featureType во время планирования маршрута.
По умолчанию всем элементам присваивается вес NeutralFeatureWeight.
Невозможно назначить вес для QGeoRouteRequest::NoFeature.
См. также featureWeight().
void QGeoRouteRequest::setManeuverDetail(ManeuverDetail maneuverDetail)
Устанавливает уровень детализации для представления маршрутных маневров в maneuverDetail.
Значение по умолчанию — QGeoRouteRequest::BasicManeuvers.
См. также maneuverDetail().
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
Устанавливает количество альтернативных маршрутов на запрос в alternatives. Если alternatives отрицательное, количество альтернативных маршрутов устанавливается в 0.
Значение по умолчанию — 0.
См. также numberAlternativeRoutes().
void QGeoRouteRequest::setRouteOptimization(RouteOptimizations optimization)
Устанавливает критерии оптимизации при планировании маршрута на optimization.
Значение по умолчанию — QGeoRouteRequest::FastestRoute.
См. также routeOptimization().
void QGeoRouteRequest::setSegmentDetail(SegmentDetail segmentDetail)
Устанавливает уровень детализации для представления маршрутных участков в segmentDetail.
См. также segmentDetail().
void QGeoRouteRequest::setTravelModes(TravelModes travelModes)
Устанавливает типы передвижения, которые должны учитываться при планировании маршрута, на travelModes.
Значение по умолчанию — QGeoRouteRequest::CarTravel.
См. также travelModes().
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
Устанавливает waypoints как точки, через которые должен пройти маршрут.
Точки должны быть указаны в порядке от начала до пункта назначения.
Этот запрос будет недействительным, пока точки не будут установлены в список, содержащий две или более координаты.
См. также waypoints().
TravelModes QGeoRouteRequest::travelModes() const
Возвращает типы передвижения, которые должны учитываться при планировании маршрута.
См. также setTravelModes().
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
Возвращает точки, через которые будет проходить маршрут.
См. также setWaypoints().
bool QGeoRouteRequest::operator!=(const QGeoRouteRequest &other) const
Возвращает, равны ли этот запрос маршрута и other.
QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
Присваивает other этому объекту запроса маршрута и возвращает ссылку на этот объект запроса маршрута.
bool QGeoRouteRequest::operator==(const QGeoRouteRequest &other) const
Возвращает, равны ли этот запрос маршрута и other.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qgeorouterequest.html