Класс MfwRoute
Предоставляет информацию о маршруте, включая расстояние, время в пути и навигационные точки. Подробнее…
| Подключение: | #include <MfwRoute> |
Свойства
|
|
Публичные функции
| MfwRoute(QObject *parent = nullptr) | |
| ~MfwRoute() | |
| QGeoCoordinate | getDestination() const |
| QVariantList | getDirections() const |
| qreal | getDistance() const |
| QGeoCoordinate | getOrigin() const |
| QVariantList | getPoints() const |
| bool | getShortest() const |
| QString | getTravelMode() const |
| qreal | getTravelTime() const |
| qreal | getUseHighways() const |
| bool | getUseOptimizations() const |
| qreal | getUseTolls() const |
| void | setDestination(QGeoCoordinate destination) |
| void | setDirections(QVariantList directions) |
| void | setDistance(qreal distance) |
| void | setOrigin(QGeoCoordinate origin) |
| void | setPoints(QVariantList points) |
| void | setShortest(bool shortest) |
| void | setTravelMode(QString travelMode) |
| void | setTravelTime(qreal travelTime) |
| void | setUseHighways(qreal useHighways) |
| void | setUseOptimizations(bool useOptimizations) |
| void | setUseTolls(qreal useTolls) |
Сигналы
| void | destinationChanged(QGeoCoordinate destination) |
| void | directionsChanged(QVariantList directions) |
| void | distanceChanged(qreal distance) |
| void | originChanged(QGeoCoordinate origin) |
| void | pointsChanged(QVariantList points) |
| void | shortestChanged(bool shortest) |
| void | travelModeChanged(QString travelMode) |
| void | travelTimeChanged(qreal travelTime) |
| void | useHighwaysChanged(qreal useHighways) |
| void | useOptimizationsChanged(bool useOptimizations) |
| void | useTollsChanged(qreal useTolls) |
Подробное описание
Предоставляет информацию о маршруте, включая расстояние, время в пути и навигационные точки.
Этот класс предназначен для инкапсуляции данных о маршруте, таких как общее расстояние, расчетное время в пути, путевые точки и пошаговые инструкции для использования в навигационных приложениях.
Описание свойств
destination : QGeoCoordinate
Функции доступа:
| QGeoCoordinate | getDestination() const |
| void | setDestination(QGeoCoordinate destination) |
Сигнал уведомления:
| void | destinationChanged(QGeoCoordinate destination) |
directions : QVariantList
Это свойство хранит QVariantList, содержащий инструкции по направлению для маршрута, отформатированные как JSON-объекты в соответствии с документацией Valhalla. Каждый элемент списка представляет собой подробную инструкцию по прохождению участка маршрута, содержащую такую информацию, как расстояние до следующего поворота, направление поворота и любые соответствующие названия дорог или идентификаторы. Такой формат позволяет получить исчерпывающие указания по маршруту, облегчает навигацию и повышает удобство пользования.
Свойство `directions` очень важно для приложений, требующих точной навигационной информации, позволяющей представлять пользователю четкие и понятные инструкции по прохождению поворотов.
Функции доступа:
| QVariantList | getDirections() const |
| void | setDirections(QVariantList directions) |
Сигнал уведомления:
| void | directionsChanged(QVariantList directions) |
distance : qreal
Функции доступа:
| qreal | getDistance() const |
| void | setDistance(qreal distance) |
Сигнал уведомления:
| void | distanceChanged(qreal distance) |
origin : QGeoCoordinate
Функции доступа:
| QGeoCoordinate | getOrigin() const |
| void | setOrigin(QGeoCoordinate origin) |
Сигнал уведомления:
| void | originChanged(QGeoCoordinate origin) |
points : QVariantList
Это свойство содержит QVariantList, который представляет маршрут, разделенный на сегменты. Каждый сегмент маршрута содержит массив координат путевых точек, через которые проходит маршрут. Каждая путевая точка представлена в виде QVariantList, содержащего два элемента: широту и долготу точки. Такая структура позволяет детально отобразить маршрут, учитывая повороты и изменения направления.
Свойство `points` необходимо для картографических приложений, предоставляя необходимые данные для построения маршрута на картографическом интерфейсе или для анализа маршрута.
Функции доступа:
| QVariantList | getPoints() const |
| void | setPoints(QVariantList points) |
Сигнал уведомления:
| void | pointsChanged(QVariantList points) |
shortest : bool
Функции доступа:
| bool | getShortest() const |
| void | setShortest(bool shortest) |
Сигнал уведомления:
| void | shortestChanged(bool shortest) |
travelMode : QString
Функции доступа:
| QString | getTravelMode() const |
| void | setTravelMode(QString travelMode) |
Сигнал уведомления:
| void | travelModeChanged(QString travelMode) |
travelTime : qreal
Функции доступа:
| qreal | getTravelTime() const |
| void | setTravelTime(qreal travelTime) |
Сигнал уведомления:
| void | travelTimeChanged(qreal travelTime) |
useHighways : qreal
Функции доступа:
| qreal | getUseHighways() const |
| void | setUseHighways(qreal useHighways) |
Сигнал уведомления:
| void | useHighwaysChanged(qreal useHighways) |
useOptimizations : bool
Функции доступа:
| bool | getUseOptimizations() const |
| void | setUseOptimizations(bool useOptimizations) |
Сигнал уведомления:
| void | useOptimizationsChanged(bool useOptimizations) |
useTolls : qreal
Функции доступа:
| qreal | getUseTolls() const |
| void | setUseTolls(qreal useTolls) |
Сигнал уведомления:
| void | useTollsChanged(qreal useTolls) |
Описание функций-членов
MfwRoute::MfwRoute(QObject *parent = nullptr)
Конструктор для создания экземпляра маршрута.
Инициализирует новый экземпляр класса MfwRoute с необязательным родителем QObject. parent parent — QObject, по умолчанию nullptr, если не указан.
MfwRoute::~MfwRoute()
Деструктор для класса MfwRoute.
Очищает ресурсы, используемые экземпляром маршрута.
[signal] void MfwRoute::destinationChanged(QGeoCoordinate destination)
Испускается при изменении конечной точки маршрута.
- destination — новая точка назначения в виде QGeoCoordinate.
Примечание. Сигнал уведомления для свойства destination.
[signal] void MfwRoute::directionsChanged(QVariantList directions)
Испускается при изменении пошаговых указаний для маршрута.
- directions — QVariantList, содержащий JSON-объекты, представляющие новые пошаговые направления для маршрута, отформатированные в соответствии с документацией Valhalla. Каждый объект JSON содержит подробные инструкции по прохождению участка маршрута, такие как направление поворотов, расстояния, а также указание ориентиров или названий дорог.
Излучение этого сигнала позволяет динамически обновлять навигационные инструкции, обеспечивая пользователям доступ к точным и полным указаниям по маршруту.
Примечание. Сигнал уведомления для свойства directions.
[signal] void MfwRoute::distanceChanged(qreal distance)
Испускается при изменении расстояния маршрута.
- distance — новое общее расстояние маршрута в метрах.
Примечание. Сигнал уведомления для свойства distance.
[signal] void MfwRoute::originChanged(QGeoCoordinate origin)
Испускается при изменении начальной точки маршрута.
- origin — новая точка начала координат в виде QGeoCoordinate.
Примечание. Сигнал уведомления для свойства origin.
[signal] void MfwRoute::pointsChanged(QVariantList points)
Испускается при изменении списка путевых точек или точек интереса на маршруте.
- points — QVariantList, где каждый элемент представляет сегмент маршрута. Внутри каждого сегмента предоставляется массив путевых точек, каждая из которых представлена в виде QVariantList, содержащего два элемента: широту и долготу точки. Такая структура позволяет составить подробную карту маршрута, проходящего через конкретные географические точки.
Обновлённый список `points` отражает изменения в путевых точках маршрута, предоставляя обновлённую информацию для целей навигации или отображения.
Примечание. Сигнал уведомления для свойства points.
void MfwRoute::setDestination(QGeoCoordinate destination)
Устанавливает конечную точку маршрута.
- destination — QGeoCoordinate, представляющая конечную точку маршрута.
Примечание. Cеттер для свойства destination.
void MfwRoute::setDirections(QVariantList directions)
Устанавливает пошаговые указания для маршрута.
- directions — QVariantList объектов JSON, каждый из которых представляет собой инструкцию для навигации по маршруту. Эти инструкции структурированы в соответствии с документацией Valhalla, что обеспечивает совместимость и полноту изложения маршрутных указаний.
Примечание. Сеттер для свойства directions.
void MfwRoute::setDistance(qreal distance)
Устанавливает общее расстояние маршрута.
- distance — общее расстояние в метрах.
Примечание. Сеттер для свойства distance.
void MfwRoute::setOrigin(QGeoCoordinate origin)
Устанавливает начальную точку маршрута.
- origin — QGeoCoordinate, представляющая начальную точку маршрута.
Примечание. Сеттер для свойства origin.
void MfwRoute::setPoints(QVariantList points)
Устанавливает путевые точки или точки интереса на маршруте.
Обновляет маршрут с новым набором путевых точек или точек интереса, определяемых QVariantList объектов QGeoCoordinate. Каждый элемент списка представляет собой сегмент маршрута, содержащий массив координат путевых точек, определяющих путь по этому сегменту. Каждая путевая точка детализируется как QVariantList с двумя элементами: широтой и долготой точки, что позволяет осуществлять точную навигацию и картографирование.
- points — QVariantList, содержащий массивы сегментов маршрута. Каждый сегмент маршрута включает массив координат путевых точек, каждая из которых представлена QVariantList, содержащим широту и долготу путевой точки. Такая структура поддерживает сложные маршруты с множеством поворотов и путевых точек, позволяя динамически обновлять маршрут по мере необходимости.
Установка новых точек для маршрута позволяет динамически корректировать его путь, например, изменять маршрут или включать дополнительные остановки, что повышает гибкость и полезность функциональности маршрутизации.
Примечание. Сеттер для свойства points.
void MfwRoute::setShortest(bool shortest)
Устанавливает предпочтение для расчета кратчайшего маршрута.
- shortest — Булево значение, указывающее на предпочтение.
Примечание. Сеттер для свойства shortest.
void MfwRoute::setTravelMode(QString travelMode)
Устанавливает режим движения для расчета маршрута.
- travelMode — QString, указывающая режим поездки. Допустимые значения: "Auto", "Taxi", "Bus", "MotorScooter", "Bicycle", и "Pedestrian".
Примечание. Сеттер для свойства travelMode.
void MfwRoute::setTravelTime(qreal travelTime)
Устанавливает расчетное время в пути для маршрута.
- travelTime — время в пути в секундах.
Примечание. Сеттер для свойства travelTime.
void MfwRoute::setUseHighways(qreal useHighways)
Устанавливает уровень предпочтения для использования автомагистралей при расчете маршрута.
- useHighways — уровень предпочтений, где более высокие значения указывают на большую готовность использовать автомагистрали.
Примечание. Сеттер для свойства useHighways.
void MfwRoute::setUseOptimizations(bool useOptimizations)
Устанавливает, следует ли использовать оптимизацию при расчете маршрута.
- useOptimizations — булево значение, указывающее, следует ли использовать оптимизацию.
Примечание. Сеттер для свойства useOptimizations.
void MfwRoute::setUseTolls(qreal useTolls)
Устанавливает уровень предпочтения для использования платных дорог при расчете маршрута.
- useTolls — уровень предпочтений, где более высокие значения указывают на большую готовность пользоваться платными дорогами.
Примечание. Сеттер для свойства useTolls.
[signal] void MfwRoute::shortestChanged(bool shortest)
Испускается при изменении предпочтений для расчета кратчайшего маршрута.
- shortest — булево значение, указывающее на новое предпочтение.
Примечание. Сигнал уведомления для свойства shortest.
[signal] void MfwRoute::travelModeChanged(QString travelMode)
Испускается при изменении режима движения для расчета маршрута.
- travelMode — новый режим путешествия в виде строки.
Примечание. Сигнал уведомления для свойства travelMode.
[signal] void MfwRoute::travelTimeChanged(qreal travelTime)
Испускается при изменении времени в пути для маршрута.
- travelTime — новое расчетное время в пути для маршрута в секундах.
Примечание. Сигнал уведомления для свойства travelTime.
[signal] void MfwRoute::useHighwaysChanged(qreal useHighways)
Испускается при изменении предпочтения использования автомагистралей при расчете маршрута.
- useHighways — новый уровень предпочтения для использования автомагистралей.
Примечание. Сигнал уведомления для свойства useHighways.
[signal] void MfwRoute::useOptimizationsChanged(bool useOptimizations)
Испускается при изменении флага для использования оптимизаций маршрута.
- useOptimizations — новое состояние использования оптимизаций маршрута.
Примечание. Сигнал уведомления для свойства useOptimizations.
[signal] void MfwRoute::useTollsChanged(qreal useTolls)
Испускается при изменении предпочтения использования платных дорог при расчете маршрута.
- useTolls — новый уровень предпочтения для использования платных дорог.
Примечание. Сигнал уведомления для свойства useTolls.