Класс QGeoPath

Класс QGeoPath определяет географическую траекторию. Подробнее...

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

Свойства

• path : QList<QGeoCoordinate>
• width : qreal

• 3 свойства унаследованы от QGeoShape

Открытые функции

• 10 открытых функций унаследованы от QGeoShape

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

Класс QGeoPath определяет географическую траекторию.

Траектория определяется упорядоченным списком QGeoCoordinates.

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

Это важно для вычисления прямоугольника ограничивающей области, возвращаемого методом QGeoShape::boundingGeoRectangle() для этой формы, который будет иметь широту левого верхнего угла, равную максимальной широте в наборе точек траектории. Аналогично, широта правого нижнего угла будет минимальной широтой в наборе точек траектории.

Этот класс является Q_GADGET. Он может быть непосредственно использован из C++ и QML.

Документация по членам-функциям

QGeoPath::QGeoPath()

Конструирует новую пустую географическую траекторию.

QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)

Конструирует новую географическую траекторию из списка координат (path и width).

QGeoPath::QGeoPath(const QGeoPath &other)

Конструирует новую географическую траекторию из содержимого other.

QGeoPath::QGeoPath(const QGeoShape &other)

Конструирует новую географическую траекторию из содержимого other.

QGeoPath::~QGeoPath()

Удаляет эту траекторию.

void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)

Добавляет coordinate к траектории.

bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const

Возвращает true, если траектория содержит coordinate в качестве одного из элементов.

QGeoCoordinate QGeoPath::coordinateAt(int index) const

Возвращает координату по индексу index.

void QGeoPath::insertCoordinate(int index, const QGeoCoordinate &coordinate)

Вставляет coordinate по указанному индексу index.

double QGeoPath::length(int indexFrom = 0, int indexTo = -1) const

Возвращает длину траектории в метрах от элемента indexFrom до элемента indexTo. Длина предназначена для суммирования кратчайших расстояний для каждой пары смежных точек.

const QList<QGeoCoordinate> &QGeoPath::path() const

Возвращает все элементы. Эквивалентно QGeoShape::center(). Центральная координата, в случае QGeoPath, представляет собой центр ограничивающего прямоугольника.

Примечание: Функция-получатель для свойства path.

См. также setPath().

void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)

Удаляет последнее вхождение coordinate из пути.

void QGeoPath::removeCoordinate(int index)

Удаляет элемент в позиции index из пути.

void QGeoPath::replaceCoordinate(int index, const QGeoCoordinate &coordinate)

Заменяет элемент пути в указанном index на coordinate.

QString QGeoPath::toString() const

Возвращает свойства гео-пути в виде строки.

void QGeoPath::translate(double degreesLatitude, double degreesLongitude)

Перемещает этот гео-путь на degreesLatitude градусов к северу и degreesLongitude градусов к востоку.

Отрицательные значения degreesLatitude и degreesLongitude соответствуют перемещению к югу и западу соответственно.

QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const

Возвращает копию этого гео-пути, перемещенного на degreesLatitude градусов к северу и degreesLongitude градусов к востоку.

Отрицательные значения degreesLatitude и degreesLongitude соответствуют перемещению к югу и западу соответственно.

См. также translate().

qreal QGeoPath::width() const

Возвращает ширину пути в метрах. Эта информация используется в методе contains. Значение по умолчанию — 0.

Примечание: Функция-геттер для свойства width.

См. также setWidth().

bool QGeoPath::operator!=(const QGeoPath &other) const

Возвращает значение, указывающее, не равен ли этот гео-путь other.

QGeoPath &QGeoPath::operator=(const QGeoPath &other)

Присваивает other этому гео-пути и возвращает ссылку на этот гео-путь.

bool QGeoPath::operator==(const QGeoPath &other) const

Возвращает значение, указывающее, равен ли этот гео-путь other.