Тип QML Navigator

Тип 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)

Методы

• 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 : Карта

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

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

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

navigatorReady : bool

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

plugin : Плагин

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

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

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

positionSource : PositionSource

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

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

См. также PositionSource.

route : Route

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

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

См. также Route.

trackPositionSource : bool

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

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

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

directions.destinationReached()

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

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

directions.waypointReached(waypoint)

Этот сигнал излучается, когда достигнута контрольная точка waypoint.

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

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

void recalculateRoutes()

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

См. также automaticReroutingEnabled.