Тип QML RouteQuery

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

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

Свойства

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

Методы

• void addExcludedArea(area)
• void addWaypoint(coordinate)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(featureType)
• void removeExcludedArea(area)
• void removeWaypoint(coordinate)
• void resetFeatureWeights()
• void setFeatureWeight(feature, FeatureWeight weight)
• список<Waypoint> waypointObjects()

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

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

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

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

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

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

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

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 : перечисление

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

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

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

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

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

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

Режимы передвижения, которые следует учитывать при планировании маршрута. Значения могут быть объединены с оператором OR ('|')

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

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

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

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

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

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

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

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

пусто addExcludedArea(area)

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

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

пусто addWaypoint(координата)

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

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

пусто clearExcludedAreas()

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

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

пусто clearWaypoints()

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

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

FeatureWeight featureWeight(featureType)

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

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

пусто removeExcludedArea(area)

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

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

пусто removeWaypoint(координата)

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

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

пусто resetFeatureWeights()

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

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

пусто setFeatureWeight(feature, FeatureWeight weight)

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

Ниже приведены возможные веса характеристик:

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

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

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

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