Spec-Zone.ru › Qt 5.6

Класс 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)

Подробное описание

Класс QGeoRouteRequest представляет параметры и ограничения, определяющие запрос на маршрутную информацию.

Стандартное состояние экземпляра QGeoRouteRequest приведет к запросу на базовые данные отрезка маршрута и маневров навигации, описывающих самый быстрый автомобильный маршрут, который охватывает заданные контрольные точки.

Существуют значительные различия в поддержке функций разными поставщиками маршрутной информации, или даже в поддержке той же функцией одним поставщиком при использовании различных уровней авторизации.

В QGeoRoutingManager имеются несколько функций, которые можно использовать для проверки поддерживаемых функций с текущим поставщиком и уровнем авторизации.

См. также QGeoRoutingManager.

Документация по типу членов

enum QGeoRouteRequest::FeatureTypeflags 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/archives/qt-5.6/qgeorouterequest.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API