Тип 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 используются исключительно для заполнения значения свойства 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 : перечисление

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void addExcludedArea(area)

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

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

void addWaypoint(coordinate)

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

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

void clearExcludedAreas()

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

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

void clearWaypoints()

Очищает все промежуточные точки.

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

FeatureWeight featureWeight(featureType)

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

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

void removeExcludedArea(area)

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

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

void removeWaypoint(coordinate)

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

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

void resetFeatureWeights()

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

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

void setFeatureWeight(feature, FeatureWeight weight)

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

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

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

список<Waypointoбъект> waypointObjects()

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

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