Класс QGeoRouteRequest

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

Этот класс был представлен в Qt 5.6.

• Список всех членов, включая унаследованные

Типы публичного доступа

Публичные функции

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

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

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

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

См. также QGeoRoutingManager.

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

перечисление QGeoRouteRequest::FeatureTypeфлаги QGeoRouteRequest::FeatureTypes

Определяет функцию, важной для планирования маршрута.

Эти значения будут использоваться в сочетании с QGeoRouteRequest::FeatureWeight, чтобы определить, должны ли они входить в состав маршрута или нет.

Тип FeatureTypes является псевдонимом для QFlags<FeatureType>. Он хранит логическое ИЛИ комбинацию значений FeatureType.

enum QGeoRouteRequest::FeatureWeightflags QGeoRouteRequest::FeatureWeights

Определяет вес, который нужно присвоить объекту при планировании маршрута.

Эти значения будут использоваться в сочетании с QGeoRouteRequest::Feature для определения, должны ли они быть частью маршрута.

Тип FeatureWeights является псевдонимом для QFlags<FeatureWeight>. Он хранит логическое ИЛИ комбинацию значений FeatureWeight.

enum QGeoRouteRequest::ManeuverDetailflags QGeoRouteRequest::ManeuverDetails

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

Тип ManeuverDetails является псевдонимом для QFlags<ManeuverDetail>. Он хранит логическое ИЛИ комбинацию значений ManeuverDetail.

enum QGeoRouteRequest::RouteOptimizationflags QGeoRouteRequest::RouteOptimizations

Определяет тип оптимизации, применяемой к планированию маршрута.

Тип RouteOptimizations является псевдонимом для QFlags<RouteOptimization>. Он хранит логическое ИЛИ комбинацию значений RouteOptimization.

enum QGeoRouteRequest::SegmentDetailflags QGeoRouteRequest::SegmentDetails

Определяет количество информации о сегментах маршрута, которое должно быть включено в маршрут.

Тип SegmentDetails является псевдонимом для QFlags<SegmentDetail>. Он хранит логическое ИЛИ комбинацию значений SegmentDetail.

enum QGeoRouteRequest::TravelModeflags QGeoRouteRequest::TravelModes

Определяет режимы передвижения для маршрута.

Тип TravelModes является псевдонимом для QFlags<TravelMode>. Он хранит логическое ИЛИ комбинацию значений TravelMode.

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

QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)

Конструирует объект запроса маршрута из содержимого other.

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

Создаёт запрос для вычисления маршрута между origin и destination.

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

Создаёт запрос для вычисления маршрута через координаты waypoints.

Маршрут будет проходить через объекты waypoints в порядке следования.

QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)

Присваивает other этому объекту запроса маршрута и возвращает ссылку на этот объект запроса маршрута.

QGeoRouteRequest::~QGeoRouteRequest()

Уничтожает запрос.

QDateTime QGeoRouteRequest::departureTime() const

Возвращает время отправления в запросе.

Эта функция была добавлена в Qt 5.13.

См. также setDepartureTime().

Список<QGeoПрямоугольник> QGeoRouteRequest::excludeAreas() const

Возвращает области, через которые маршрут не должен проходить.

См. также setExcludeAreas().

QVariantMap QGeoRouteRequest::extraParameters() const

Возвращает дополнительные параметры, заданные для данного запроса маршрута.

Эта функция была добавлена в Qt 5.11.

См. также setExtraParameters().

Список<ТипОсобенностьQGeoRouteRequest> QGeoRouteRequest::featureTypes() const

Возвращает список особенностей, которые будут учтены при планировании маршрута. Особенности с весом NeutralFeatureWeight не будут возвращены.

ВесОсобенностьQGeoRouteRequest QGeoRouteRequest::featureWeight(ТипОсобенностьQGeoRouteRequest featureType) const

Возвращает вес, назначенный featureType при планировании маршрута.

Если для featureType не был задан вес, то будет возвращён NeutralFeatureWeight.

См. также setFeatureWeight().

ПодробностиМаневрQGeoRouteRequest QGeoRouteRequest::maneuverDetail() const

Возвращает уровень детализации, который будет использован в представлении маневров маршрута.

См. также setManeuverDetail().

int QGeoRouteRequest::numberAlternativeRoutes() const

Возвращает количество альтернативных маршрутов, которые будут запрошены.

См. также setNumberAlternativeRoutes().

ОптимизацияМаршрутаQGeoRouteRequest QGeoRouteRequest::routeOptimization() const

Возвращает критерии оптимизации, которые этот запрос указывает использовать при планировании маршрута.

См. также setRouteOptimization().

ПодробностиОтрезкаQGeoRouteRequest QGeoRouteRequest::segmentDetail() const

Возвращает уровень детализации, который будет использован в представлении отрезков маршрута.

См. также setSegmentDetail().

void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)

Устанавливает время отправления departureTime для расчета маршрута. Эта информация может быть использована сервером для расчета более быстрого маршрута, например, избегая заторов в часы пик.

Значение по умолчанию — некорректное QDateTime.

Эта функция была добавлена в Qt 5.13.

См. также departureTime().

void QGeoRouteRequest::setExcludeAreas(const QList<QGeoПрямоугольник> &areas)

Устанавливает areas как исключённые области, через которые маршрут не должен проходить.

См. также excludeAreas().

void QGeoRouteRequest::setExtraParameters(const QVariantMap &extraParameters)

Устанавливает дополнительные параметры extraParameters для запроса маршрута. Формат дополнительных параметров специфичен для плагина и документирован для каждого плагина.

Эта функция была добавлена в Qt 5.11.

См. также extraParameters().

void QGeoRouteRequest::setFeatureWeight(ТипОсобенностьQGeoRouteRequest featureType, ВесОсобенностьQGeoRouteRequest featureWeight)

Назначает вес featureWeight для особенности featureType при планировании маршрута.

По умолчанию всем особенностям назначается вес NeutralFeatureWeight.

Невозможно назначить вес для QGeoRouteRequest::NoFeature.

См. также featureWeight().

void QGeoRouteRequest::setManeuverDetail(ПодробностиМаневрQGeoRouteRequest maneuverDetail)

Устанавливает уровень детализации для представления маневров маршрута в maneuverDetail.

Значение по умолчанию — QGeoRouteRequest::BasicManeuvers.

См. также maneuverDetail().

void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)

Устанавливает количество альтернативных маршрутов на запрос в alternatives. Если alternatives отрицательно, количество альтернативных маршрутов устанавливается в 0.

Значение по умолчанию — 0.

См. также numberAlternativeRoutes().

void QGeoRouteRequest::setRouteOptimization(ОптимизацияМаршрутаQGeoRouteRequest optimization)

Устанавливает критерии оптимизации для планирования маршрута в optimization.

Значение по умолчанию — QGeoRouteRequest::FastestRoute.

См. также routeOptimization().

void QGeoRouteRequest::setSegmentDetail(ПодробностиОтрезкаQGeoRouteRequest segmentDetail)

Устанавливает уровень детализации для представления отрезков маршрута в segmentDetail.

См. также segmentDetail().

void QGeoRouteRequest::setTravelModes(РежимыПередвиженияQGeoRouteRequest travelModes)

Устанавливает режимы передвижения, которые должны учитываться при планировании маршрута, в travelModes.

Значение по умолчанию — QGeoRouteRequest::CarTravel.

См. также travelModes().

void QGeoRouteRequest::setWaypoints(const QList<QGeoКоордината> &waypoints)

Устанавливает waypoints как точки, через которые должен проходить маршрут.

Точки должны быть заданы в порядке от начала до пункта назначения.

Этот запрос будет недействительным, пока точки не будут установлены в список, содержащий две или более координат.

См. также waypoints().

void QGeoRouteRequest::setWaypointsMetadata(const QList<QVariantMap> &waypointMetadata)

Устанавливает waypointMetadata в качестве метаданных для точек, заданных в этом запросе. Метаданные предназначены как один QVariantMap на точку, заданные в том же порядке, что и точки.

Содержание QVariantMap каким-то образом специфично для сервера, но можно предположить, что свойства, которые можно указать с помощью элементов Waypoint в QML, называются и работают одинаково во всех плагинах, где это поддерживается.

См. также waypointsMetadata().

РежимыПередвиженияQGeoRouteRequest QGeoRouteRequest::travelModes() const

Возвращает режимы передвижения, которые этот запрос указывает использовать при планировании маршрута.

См. также setTravelModes().

Список<QGeoКоордината> QGeoRouteRequest::waypoints() const

Возвращает точки, через которые будет проходить маршрут.

См. также setWaypoints().

Список<QVariantMap> QGeoRouteRequest::waypointsMetadata() const

Возвращает метаданные для точек в этом запросе.

См. также setWaypointsMetadata().

bool QGeoRouteRequest::operator!=(const QGeoRouteRequest &other) const

Возвращает, равны ли этот запрос маршрута и other.

bool QGeoRouteRequest::operator==(const QGeoRouteRequest &other) const

Возвращает, равняется ли запрос на маршрут и другой.