Тип QML RouteQuery

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

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

Свойства

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

Методы

• void addExcludedArea(georectangle)
• void addWaypoint(координата)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(FeatureType featureType)
• void removeExcludedArea(georectangle)
• void removeWaypoint(координата)
• void resetFeatureWeights()
• void setFeatureWeight(FeatureType, FeatureWeight)

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

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

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

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

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

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

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

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

См. также RouteModel.

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

excludedAreas : список<georectangle>

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

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

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

featureTypes : QList<FeatureType>

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

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

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

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

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

• RouteQuery.NoManeuvers - Маневры не должны быть включены в маршрут
• RouteQuery.BasicManeuvers - Базовые маневры будут включены в маршрут

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

numberAlternativeRoutes : int

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

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

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

• RouteQuery.ShortestRoute - Минимизация длины поездки
• RouteQuery.FastestRoute - Минимизация времени поездки
• RouteQuery.MostEconomicRoute - Минимизация стоимости поездки
• RouteQuery.MostScenicRoute - Максимизация живописности поездки

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

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

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

• RouteQuery.NoSegmentData - Данные сегмента не должны быть включены в маршрут
• RouteQuery.BasicSegmentData - Базовые данные сегмента будут включены в маршрут

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

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

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

• RouteQuery.CarTravel - Маршрут будет оптимизирован для водителя автомобиля
• RouteQuery.PedestrianTravel - Маршрут будет оптимизирован для пешехода
• RouteQuery.BicycleTravel - Маршрут будет оптимизирован для велосипедиста
• RouteQuery.PublicTransitTravel - Маршрут будет оптимизирован для использования общественного транспорта
• RouteQuery.TruckTravel - Маршрут будет оптимизирован для водителя грузовика

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

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

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

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

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

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

void addExcludedArea(georectangle)

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

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

void addWaypoint(координата)

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

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

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

Список возможных весов функций:

• RouteQuery.NeutralFeatureWeight - Наличие или отсутствие объекта не повлияет на планирование маршрута
• RouteQuery.PreferFeatureWeight - Маршруты, содержащие объект, будут предпочтительнее маршрутов, его не содержащих
• RouteQuery.RequireFeatureWeight - Будут рассматриваться только маршруты, содержащие объект; в противном случае маршрут не будет возвращён
• RouteQuery.AvoidFeatureWeight - Маршруты, не содержащие объект, будут предпочтительнее маршрутов, его содержащих
• RouteQuery.DisallowFeatureWeight - Будут рассматриваться только маршруты, не содержащие объект; в противном случае маршрут не будет возвращён

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