QGeoCoordinate Class

Member Function Documentation

[since 6.2] QGeoCoordinate::QGeoCoordinate(QGeoCoordinate &&other)

Constructs a coordinate by moving from other.

This function was introduced in Qt 6.2.

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

Constructs a coordinate from the contents of other.

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

Constructs a coordinate with the given latitude, longitude and altitude.

If the latitude is not between -90 to 90 inclusive, or the longitude is not between -180 to 180 inclusive, none of the values are set and the type() will be QGeoCoordinate::InvalidCoordinate.

Note that altitude specifies the meters above sea level.

See also isValid().

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

Constructs a coordinate with the given latitude and longitude.

If the latitude is not between -90 to 90 inclusive, or the longitude is not between -180 to 180 inclusive, none of the values are set and the type() will be QGeoCoordinate::InvalidCoordinate.

See also isValid().

QGeoCoordinate::QGeoCoordinate()

Constructs a coordinate. The coordinate will be invalid until setLatitude() and setLongitude() have been called.

[since 6.2] QGeoCoordinate &QGeoCoordinate::operator=(QGeoCoordinate &&other)

Move-assigns other to this coordinate and returns a reference to this coordinate.

This function was introduced in Qt 6.2.

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

Assigns other to this coordinate and returns a reference to this coordinate.

QGeoCoordinate::~QGeoCoordinate()

Destroys the coordinate object.

double QGeoCoordinate::altitude() const

Returns the altitude (meters above sea level).

The return value is undefined if the altitude has not been set.

Note: Getter function for property altitude.

See also setAltitude() and type().

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

Returns the coordinate that is reached by traveling distance meters from the current coordinate at azimuth (or bearing) along a great-circle. There is an assumption that the Earth is spherical for the purpose of this calculation.

The altitude will have distanceUp added to it.

Returns an invalid coordinate if this coordinate is invalid.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[invokable] qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const

Returns the azimuth (or bearing) in degrees from this coordinate to the coordinate specified by other. Altitude is not used in the calculation.

The bearing returned is the bearing from the origin to other along the great-circle between the two coordinates. There is an assumption that the Earth is spherical for the purpose of this calculation.

Returns 0 if the type of this coordinate or the type of other is QGeoCoordinate::InvalidCoordinate.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[invokable] qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const

Returns the distance (in meters) from this coordinate to the coordinate specified by other. Altitude is not used in the calculation.

This calculation returns the great-circle distance between the two coordinates, with an assumption that the Earth is spherical for the purpose of this calculation.

Returns 0 if the type of this coordinate or the type of other is QGeoCoordinate::InvalidCoordinate.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

bool QGeoCoordinate::isValid() const

Returns true if the longitude and latitude are valid.

Note: Getter function for property isValid.

double QGeoCoordinate::latitude() const

Returns the latitude, in decimal degrees. The return value is undefined if the latitude has not been set.

A positive latitude indicates the Northern Hemisphere, and a negative latitude indicates the Southern Hemisphere.

Note: Getter function for property latitude.

See also setLatitude() and type().

double QGeoCoordinate::longitude() const

Returns the longitude, in decimal degrees. The return value is undefined if the longitude has not been set.

A positive longitude indicates the Eastern Hemisphere, and a negative longitude indicates the Western Hemisphere.

Note: Getter function for property longitude.

See also setLongitude() and type().

void QGeoCoordinate::setAltitude(double altitude)

Sets the altitude (meters above sea level) to altitude.

Note: Setter function for property altitude.

See also altitude().

void QGeoCoordinate::setLatitude(double latitude)

Sets the latitude (in decimal degrees) to latitude. The value should be in the WGS84 datum.

To be valid, the latitude must be between -90 to 90 inclusive.

Note: Setter function for property latitude.

See also latitude().

void QGeoCoordinate::setLongitude(double longitude)

Sets the longitude (in decimal degrees) to longitude. The value should be in the WGS84 datum.

To be valid, the longitude must be between -180 to 180 inclusive.

Note: Setter function for property longitude.

See also longitude().

[invokable] QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const

Returns this coordinate as a string in the specified format.

For example, if this coordinate has a latitude of -27.46758, a longitude of 153.027892 and an altitude of 28.1, these are the strings returned depending on format:

The altitude field is omitted if no altitude is set.

If the coordinate is invalid, an empty string is returned.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

QGeoCoordinate::CoordinateType QGeoCoordinate::type() const

Returns the type of this coordinate.