Тип QML Navigator

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

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

Свойства

• active : bool
• directions
  • directions.nextManeuverIcon : Variant
  • directions.distanceToNextManeuver : real
  • directions.remainingTravelDistance : real
  • directions.remainingTravelDistanceToNextWaypoint : real
  • directions.traveledDistance : real
  • directions.timeToNextManeuver : int
  • directions.remainingTravelTime : int
  • directions.remainingTravelTimeToNextWaypoint : int
  • directions.traveledTime : int
  • directions.currentRoute : Route
  • directions.currentRouteLeg : RouteLeg
  • directions.currentSegment : int
• error : перечисление
• map : Map
• navigatorReady : bool
• plugin : Plugin
• positionSource : PositionSource
• route : Route
• trackPositionSource : bool

Сигналы

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

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

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

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

active : bool

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

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

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

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

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

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

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

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

map : Map

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

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

См. также Map.

navigatorReady : bool

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

plugin : Plugin

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

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

См. также Plugin.

positionSource : PositionSource

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

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

См. также PositionSource.

route : Route

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

Примечание: Это свойство не обязательно совпадает с currentRoute. currentRoute может отличаться во время маршрутизации по разным причинам. Однако можно предположить, что пункт назначения currentRoute будет таким же, как пункт назначения route.

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

См. также Route.

trackPositionSource : bool

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

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

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

directions.destinationReached()

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

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

directions.waypointReached(waypoint)

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

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