Тип QML RouteQuery

Тип RouteQuery используется для предоставления параметров запроса к RouteModel. Подробнее...

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

Свойства

• departureTime : дата
• excludedAreas : список<геопрямоугольник>
• extraParameters : VariantMap
• featureTypes : QList<FeatureType>
• maneuverDetail : перечисление
• numberAlternativeRoutes : int
• routeOptimizations : перечисление
• segmentDetail : перечисление
• travelModes : перечисление
• waypoints : список<координата>

Методы

• void addExcludedArea(геопрямоугольник area)
• void addWaypoint(координата)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(FeatureType featureType)
• void removeExcludedArea(геопрямоугольник area)
• void removeWaypoint(координата)
• void resetFeatureWeights()
• void setFeatureWeight(FeatureType feature, FeatureWeight weight)
• список<Waypoint> waypointObjects()

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

RouteQuery используется для упаковки всех параметров, необходимых для отправки запроса в службу маршрутизации, которая затем может заполнить содержимое RouteModel.

Эти параметры описывают ключевые детали маршрута, такие как waypoints для прохождения, excludedAreas для избегания, используемые travelModes, а также подробные предпочтения по оптимизации маршрута и предпочтению или избеганию определенных элементов пути (таких как платные дороги, автомагистрали и т.д.).

Объекты RouteQuery используются исключительно для заполнения значения свойства query RouteModel, которое затем может начать процесс извлечения данных для заполнения модели.

Некоторые плагины могут разрешать или требовать определённых параметров для работы. Для указания этих параметров, специфичных для плагина, элементы MapParameter могут быть вложены внутри RouteQuery.

Пример использования

Следующий фрагмент показывает неполный пример создания объекта RouteQuery и его установки в качестве значения свойства query RouteModel.

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

Для более полного примера см. документацию для типа RouteModel и пример Mapviewer.

См. также RouteModel.

Документация по свойствам

departureTime : дата

Время отправления, используемое при запросе маршрута. Значение по умолчанию — недействительная дата, что означает, что время отправления не будет использоваться в запросе.

Это свойство было добавлено в Qt 5.13.

excludedAreas : список<геопрямоугольник>

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

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

См. также addExcludedArea, removeExcludedArea и clearExcludedAreas.

[только для чтения] extraParameters : VariantMap

Дополнительные параметры запроса маршрута. Это свойство только для чтения. Если запрос определен пользователем, эти параметры можно установить с помощью MapParameters. Если запрос маршрута поступает от движка через сигналы, запрос предназначен для чтения.

Это свойство было добавлено в Qt 5.11.

featureTypes : QList<FeatureType>

Список элементов, которые будут учитываться при планировании маршрута. Элементы с весом NeutralFeatureWeight не будут возвращены.

• RouteQuery.NoFeature - При планировании маршрута не будут учитываться никакие элементы
• RouteQuery.TollFeature - Учитывать платные дороги при планировании маршрута
• RouteQuery.HighwayFeature - Учитывать автомагистрали при планировании маршрута
• RouteQuery.PublicTransitFeature - Учитывать общественный транспорт при планировании маршрута
• RouteQuery.FerryFeature - Учитывать паромы при планировании маршрута
• RouteQuery.TunnelFeature - Учитывать туннели при планировании маршрута
• RouteQuery.DirtRoadFeature - Учитывать грунтовые дороги при планировании маршрута
• RouteQuery.ParksFeature - Учитывать парки при планировании маршрута
• RouteQuery.MotorPoolLaneFeature - Учитывать полосы движения автобазы при планировании маршрута
• RouteQuery.TrafficFeature - Учитывать трафик при планировании маршрута

См. также setFeatureWeight и featureWeight.

maneuverDetail : перечисление

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

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

numberAlternativeRoutes : int

Количество альтернативных маршрутов, запрашиваемых при запросе маршрутов. Значение по умолчанию — 0.

routeOptimizations : перечисление

Оптимизации маршрута, которые следует учитывать при планировании маршрута. Значения могут быть объединены с помощью оператора ИЛИ ('|')

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

segmentDetail : перечисление

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

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

travelModes : перечисление

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

waypoints : список<координата>

Координаты точек маршрута. Точки должны быть заданы в порядке от начала до конца. Требуются две или более координаты.

Точки могут быть заданы как часть объявления типа RouteQuery или динамически с помощью предоставленных функций.

При установке этого свойства в список точек каждая точка может быть либо координатой, либо Waypoint — взаимозаменяемо. Если передается координата, она будет преобразована в Waypoint в системе.

Однако это свойство всегда содержит список координат.

См. также waypointObjects, addWaypoint, removeWaypoint и clearWaypoints.

Документация методов

void addExcludedArea(georectangle area)

Добавляет указанный геопрямоугольник area в исключённые области (области, через которые маршрут не должен проходить). Одна и та же область может быть добавлена только один раз.

См. также removeExcludedArea и clearExcludedAreas.

void addWaypoint(coordinate)

Добавляет координату в список точек маршрута. Одну и ту же координату можно задать несколько раз. Аргумент coordinate может быть координатой или Waypoint. Если используется координата, она будет преобразована в Waypoint в системе.

См. также removeWaypoint и clearWaypoints.

void clearExcludedAreas()

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

См. также addExcludedArea и removeExcludedArea.

void clearWaypoints()

Очищает все точки маршрута.

См. также removeWaypoint и addWaypoint.

FeatureWeight featureWeight(FeatureType featureType)

Возвращает вес для featureType.

См. также featureTypes, setFeatureWeight и resetFeatureWeights.

void removeExcludedArea(georectangle area)

Удаляет указанную area из исключённых областей (области, через которые маршрут не должен проходить).

См. также addExcludedArea и clearExcludedAreas.

void removeWaypoint(coordinate)

Удаляет заданную coordinate из списка точек маршрута. Если одна и та же координата встречается несколько раз, удаляется последняя добавленная её экземпляр.

См. также addWaypoint и clearWaypoints.

void resetFeatureWeights()

Сбрасывает все весы функций до их состояния по умолчанию (NeutralFeatureWeight).

См. также featureTypes, setFeatureWeight и featureWeight.

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

Определяет weight, связанный с feature при планировании маршрута.

Ниже приведены возможные весы функций:

См. также featureTypes, resetFeatureWeights и featureWeight.

список<Waypoint> waypointObjects()

Этот метод используется для получения списка объектов Waypoint, относящихся к RouteQuery::waypoints.

См. также waypointObjects, addWaypoint, removeWaypoint и clearWaypoints.