Тип QML RouteQuery

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

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

Свойства

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

Методы

• void addExcludedArea(georectangle)
• void addWaypoint(coordinate)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(ТипОсобенности featureType)
• void removeExcludedArea(georectangle)
• void removeWaypoint(coordinate)
• void resetFeatureWeights()
• void setFeatureWeight(ТипОсобенности, 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<ТипОсобенности>

Список особенностей, которые будут учитываться при планировании маршрута. Особенности с весом 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.