Тип RouteQuery QML

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

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

Свойства

• excludedAreas : list<georectangle>
• featureTypes : QList<FeatureType>
• maneuverDetail : перечисление
• numberAlternativeRoutes : int
• routeOptimizations : перечисление
• segmentDetail : перечисление
• travelModes : перечисление
• waypoints : QJSValue

Методы

• void addExcludedArea(georectangle)
• void addWaypoint(coordinate)
• void clearExcludedAreas()
• void clearWaypoints()
• FeatureWeight featureWeight(FeatureType featureType)
• void removeExcludedArea(georectangle)
• void removeWaypoint(coordinate)
• 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 : list<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 : QJSValue

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

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

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

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

void addExcludedArea(georectangle)

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

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

void addWaypoint(coordinate)

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

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