Класс QGeoCoordinate

Класс QGeoCoordinate определяет географическую позицию на поверхности Земли. Подробнее...

Этот класс был представлен в Qt 5.2.

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

Открытые типы

Свойства

• altitude : double
• isValid : const bool
• latitude : double
• longitude : double

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

Связанные нечлены

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

QGeoCoordinate определяется широтой, долготой и, необязательно, высотой.

Используйте type(), чтобы определить, является ли координата 2D координатой (имеет только широту и долготу) или 3D координатой (имеет широту, долготу и высоту). Используйте distanceTo() и azimuthTo(), чтобы вычислить расстояние и азимут между координатами.

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

Азимут в этом контексте эквивалентен направлению компаса по отношению к истинному северу.

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

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

перечисление QGeoCoordinate::CoordinateFormat

Определяет возможные параметры форматирования для toString().

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

перечисление QGeoCoordinate::CoordinateType

Определяет типы координат.

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

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

Возвращает true если широта, долгота или высота этой координаты не идентичны other.

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

Создает координату из содержимого other.

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude, double altitude)

Создаёт координату с заданной latitude, longitude и altitude.

Если широта не находится в диапазоне от -90 до 90 включительно, или долгота не находится в диапазоне от -180 до 180 включительно, ни одно из значений не устанавливается, и type() будет QGeoCoordinate::InvalidCoordinate.

Обратите внимание, что altitude указывает высоту в метрах над уровнем моря.

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

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

Создаёт координату с заданной latitude и longitude.

Если широта не находится в диапазоне от -90 до 90 включительно, или долгота не находится в диапазоне от -180 до 180 включительно, ни одно из значений не устанавливается, и type() будет QGeoCoordinate::InvalidCoordinate.

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

QGeoCoordinate::QGeoCoordinate()

Создаёт координату. Координата будет недействительной до тех пор, пока не будут вызваны setLatitude() и setLongitude().

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

Присваивает other этой координате и возвращает ссылку на эту координату.

QGeoCoordinate::~QGeoCoordinate()

Удаляет объект координаты.

double QGeoCoordinate::altitude() const

Возвращает высоту (в метрах над уровнем моря).

Возвращаемое значение не определено, если высота не была задана.

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

См. также setAltitude() и type().

QGeoCoordinate QGeoCoordinate::atDistanceAndAzimuth(qreal distance, qreal azimuth, qreal distanceUp = 0.0) const

Возвращает координату, достигнутую при перемещении на distance метров от текущей координаты по азимуту azimuth (или направлению) по большой окружности. Предполагается, что Земля является сферической для целей этого расчёта.

К высоте будет добавлено distanceUp.

Возвращает недействительную координату, если эта координата недействительна.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const

Возвращает азимут (или направление) в градусах от этой координаты до координаты, указанной other. Высота не используется в вычислениях.

Возвращаемое направление — направление от начала до other по большой окружности между двумя координатами. Предполагается, что Земля является сферической для целей этого расчёта.

Возвращает 0, если тип этой координаты или тип other — QGeoCoordinate::InvalidCoordinate.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const

Возвращает расстояние (в метрах) от этой координаты до координаты, указанной other. Высота не используется в вычислениях.

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

Возвращает 0, если тип этой координаты или тип other — QGeoCoordinate::InvalidCoordinate.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

bool QGeoCoordinate::isValid() const

Возвращает true если longitude и latitude валидны.

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

double QGeoCoordinate::latitude() const

Возвращает широту в десятичных градусах. Возвращаемое значение не определено, если широта не была задана.

Положительная широта указывает на Северное полушарие, отрицательная — на Южное.

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

См. также setLatitude() и type().

double QGeoCoordinate::longitude() const

Возвращает долготу в десятичных градусах. Возвращаемое значение не определено, если долгота не была задана.

Положительная долгота указывает на Восточное полушарие, отрицательная — на Западное.

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

См. также setLongitude() и type().

void QGeoCoordinate::setAltitude(double altitude)

Устанавливает высоту (в метрах над уровнем моря) в altitude.

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

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

void QGeoCoordinate::setLatitude(double latitude)

Устанавливает широту (в десятичных градусах) в latitude. Значение должно быть в системе координат WGS84.

Для корректности широта должна быть в диапазоне от -90 до 90 включительно.

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

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

void QGeoCoordinate::setLongitude(double longitude)

Устанавливает долготу (в десятичных градусах) в longitude. Значение должно быть в системе координат WGS84.

Для корректности долгота должна быть в диапазоне от -180 до 180 включительно.

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

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

QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const

Возвращает эти координаты в виде строки в указанном формате format.

Например, если у этих координат широта -27.46758, долгота 153.027892 и высота 28.1, то следующие строки будут возвращены в зависимости от format:

Поле высоты опускается, если высота не установлена.

Если координаты некорректны, возвращается пустая строка.

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

QGeoCoordinate::CoordinateType QGeoCoordinate::type() const

Возвращает тип этих координат.

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

Возвращает true, если широта, долгота и высота этих координат совпадают с соответствующими значениями other.

Долгота будет проигнорирована, если широта равна +/- 90 градусов.