Тип Navigator QML

Тип Navigator предоставляет функциональность для выполнения навигации по шагам. Подробнее...

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

Свойства

• active : bool
• automaticReroutingEnabled : bool
• directions
  • directions.alternativeRoutes : модель
  • directions.currentRoute : Маршрут
  • directions.currentRouteLeg : Элемент маршрута
  • directions.currentSegment : int
  • directions.distanceToNextManeuver : вещественный
  • directions.nextManeuverIcon : Вариант
  • directions.remainingTravelDistance : вещественный
  • directions.remainingTravelDistanceToNextWaypoint : вещественный
  • directions.remainingTravelTime : int
  • directions.remainingTravelTimeToNextWaypoint : int
  • directions.timeToNextManeuver : int
  • directions.traveledDistance : вещественный
  • directions.traveledTime : int
• error : перечисление
• isOnRoute : bool
• map : Карта
• navigatorReady : bool
• plugin : Плагин
• positionSource : Источник позиции
• route : Маршрут
• trackPositionSource : bool

Сигналы

• directions.destinationReached()
• directions.waypointReached(Waypoint waypoint)

Методы

• void recalculateRoutes()

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

Цель Navigator — использовать реализацию навигации по шагам плагина в приложении QML плавно. Этот объект может управлять положением, ориентацией, наклоном и масштабом карты, а также изменением стиля карты, элементов на карте, таких как информация о направлении. В некоторых случаях он также может ограничить взаимодействие пользователя с картой и элементами на ней.

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

active : bool

Это свойство указывает, активна ли навигация в Navigator. Установите это свойство в true для запуска навигации. Установите его в false для остановки активной сессии навигации.

automaticReroutingEnabled : bool

Это свойство указывает, следует ли Navigator автоматически пересчитывать маршрут, когда позиция из positionSource слишком сильно отклоняется от маршрута. Операция в этом случае эквивалентна вызову recalculateRoutes. Значение по умолчанию — true.

Примечание: Влияние этого свойства зависит от плагина. Также, влияет ли оно во время активности навигатора, зависит от плагина.

[только для чтения] directions.alternativeRoutes : модель

Эти свойства только для чтения являются частью группы свойств directions. Эта группа свойств содержит информацию о ходе навигации, которая может использоваться для доступа к данным маршрута и извлечения инструкций.

Примечание: Некоторые бэкэнды могут не предоставлять полную информацию о ходе навигации.

• Свойство nextManeuverIcon содержит значок следующего поворота.
• Свойство distanceToNextManeuver содержит расстояние до следующего маневра в метрах.
• Свойство remainingTravelDistance содержит оставшееся расстояние в метрах.
• Свойство remainingTravelDistanceToNextWaypoint содержит оставшееся расстояние до следующей точки маршрута в метрах.
• Свойство traveledDistance содержит пройденное расстояние в метрах.
• Свойство timeToNextManeuver содержит время до следующего маневра в миллисекундах.
• Свойство remainingTravelTime содержит оставшееся время в миллисекундах.
• Свойство remainingTravelTimeToNextWaypoint содержит оставшееся время до следующей точки маршрута в миллисекундах.
• Свойство traveledTime содержит время, затраченное на дорогу в миллисекундах.
• Свойство currentRoute содержит текущий маршрут, за которым следует навигатор. Он может быть таким же, как и route, или отличаться, если навигатор не может следовать заданному пользователем маршруту. Например, если позиция, полученная от positionSource, значительно отличается от маршрута, движок навигации может пересчитать и начать следовать новому маршруту.
• Свойство currentRouteLeg содержит текущий элемент маршрута, за которым следует навигатор. Это всегда часть currentRoute, поэтому свойство overallRoute currentRouteLeg содержит тот же маршрут, что и currentRoute.
• Свойство currentSegment содержит индекс текущего RouteSegment в currentRoute.
• Свойство alternativeRoutes содержит список альтернативных маршрутов, предоставленных движком. Если альтернативных маршрутов нет, модель будет пустой.

См. также directions.waypointReached(), directions.destinationReached(), Route, RouteLeg, RouteSegment и Waypoint.

[только для чтения] error : перечисление

Это свойство только для чтения содержит последнее значение ошибки запроса геокодирования.

isOnRoute : bool

Пока навигатор находится в активном режиме отслеживания, это свойство указывает, находится ли позиция из positionSource на маршруте или нет.

map : Карта

Это свойство содержит карту, за управлением которой отвечает навигатор.

Это свойство можно задать один раз. После того, как навигатор связан с картой, любые попытки изменить свойство map будут проигнорированы.

См. также Карта.

navigatorReady : bool

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

plugin : Плагин

Это свойство содержит плагин, предоставляющий функциональность навигации.

Это свойство можно задать один раз. После того, как навигатор связан с плагином, любые попытки изменить свойство plugin будут проигнорированы.

См. также Плагин.

positionSource : PositionSource

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

Это свойство можно установить только один раз. После того, как навигатору будет назначен PositionSource, любые попытки изменить свойство positionSource будут проигнорированы.

См. также PositionSource.

route : Маршрут

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

Примечание: Установка этого свойства во время текущей сессии навигации остановит навигацию.

См. также Маршрут.

trackPositionSource : bool

Это свойство указывает, следует ли навигатору управлять камерой карты, чтобы отслеживать обновления источника местоположения. Это свойство включено (true) по умолчанию, и его установка в false полезна в тех случаях, когда, например, пользователь начинает жестикулировать над областью карты.

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

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

directions.destinationReached()

Этот сигнал испускается, когда последняя точка маршрута, пункт назначения, достигнута.

Примечание: Соответствующий обработчик — onDirections.destinationReached.

См. также directions и directions.waypointReached().

directions.waypointReached(Точка waypoint)

Этот сигнал испускается, когда достигнута точка маршрута waypoint.

Примечание: Соответствующий обработчик — onDirections.waypointReached.

См. также directions и directions.destinationReached().

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

void recalculateRoutes()

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

См. также automaticReroutingEnabled.