Класс QGeoRouteRequest

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

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

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

Открытые типы

Открытые функции

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

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

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

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

См. также QGeoRoutingManager.

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

enum QGeoRouteRequest::FeatureTypeflags QGeoRouteRequest::FeatureTypes

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

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

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

перечисление QGeoRouteRequest::FeatureWeightфлаги QGeoRouteRequest::FeatureWeights

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

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

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

перечисление QGeoRouteRequest::ManeuverDetailфлаги QGeoRouteRequest::ManeuverDetails

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

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

перечисление QGeoRouteRequest::RouteOptimizationфлаги QGeoRouteRequest::RouteOptimizations

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

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

перечисление QGeoRouteRequest::SegmentDetailфлаги QGeoRouteRequest::SegmentDetails

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

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

перечисление QGeoRouteRequest::TravelModeфлаги 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

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