Тип QML RouteQuery

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

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

Свойства

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

Методы

• void addExcludedArea(георёктугол)
• void addWaypoint(координата)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(FeatureType featureType)
• void removeExcludedArea(георёктугол)
• void removeWaypoint(координата)
• void resetFeatureWeights()
• void setFeatureWeight(FeatureType, FeatureWeight)
• список<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.

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

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

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

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

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

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

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

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

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

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

void addExcludedArea(georectangle)

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

См. также 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)

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

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

void removeWaypoint(coordinate)

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

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

void resetFeatureWeights()

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

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

void setFeatureWeight(FeatureType, FeatureWeight)

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

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

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

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

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

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