# QGeoCoordinate

Since: 1.0

#include <QtLocationSubset/QGeoCoordinate>

The QGeoCoordinate class defines a geographical position on the surface of the Earth.

A QGeoCoordinate is defined by latitude, longitude, and optionally, altitude.

Use type() to determine whether a coordinate is a 2D coordinate (has latitude and longitude only) or 3D coordinate (has latitude, longitude and altitude). Use distanceTo() and azimuthTo() to calculate the distance and bearing between coordinates.

The coordinate values should be specified using the WGS84 datum.

## Overview

### Public Types Index

## enum CoordinateFormatDegrees, DegreesWithHemisphere, DegreesMinutes, DegreesMinutesWithHemisphere, DegreesMinutesSeconds, DegreesMinutesSecondsWithHemisphere | |

## enum CoordinateType |

### Public Functions Index

QGeoCoordinate () | |

QGeoCoordinate (double latitude, double longitude) | |

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

QGeoCoordinate (const QGeoCoordinate &other) | |

~QGeoCoordinate () | |

double | altitude () const |

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

qreal | azimuthTo (const QGeoCoordinate &other) const |

qreal | distanceTo (const QGeoCoordinate &other) const |

bool | isValid () const |

double | latitude () const |

double | longitude () const |

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

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

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

void | setAltitude (double altitude) |

void | setLatitude (double latitude) |

void | setLongitude (double longitude) |

QString | toString (CoordinateFormat format=DegreesMinutesSecondsWithHemisphere) const |

CoordinateType | type () const |

## Public Types

Defines the possible formatting options for toString().

Degrees Returns a string representation of the coordinates in decimal degrees format. DegreesWithHemisphere Returns a string representation of the coordinates in decimal degrees format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates. DegreesMinutes Returns a string representation of the coordinates in degrees-minutes format. DegreesMinutesWithHemisphere Returns a string representation of the coordinates in degrees-minutes format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates. DegreesMinutesSeconds Returns a string representation of the coordinates in degrees-minutes-seconds format. DegreesMinutesSecondsWithHemisphere Returns a string representation of the coordinates in degrees-minutes-seconds format, using 'N', 'S', 'E' or 'W' to indicate the hemispheres of the coordinates.

- Degrees
- DegreesWithHemisphere
- DegreesMinutes
- DegreesMinutesWithHemisphere
- DegreesMinutesSeconds
- DegreesMinutesSecondsWithHemisphere

Defines the types of a coordinate.

InvalidCoordinate An invalid coordinate. A coordinate is invalid if its latitude or longitude values are invalid. Coordinate2D A coordinate with valid latitude and longitude values. Coordinate3D A coordinate with valid latitude and longitude values, and also an altitude value.

- InvalidCoordinate
- Coordinate2D
- Coordinate3D

## Public Functions

Constructs a coordinate.

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

Constructs a coordinate with the given latitude and longitude.

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

Constructs a coordinate from the contents of other.

Destructor.

### double

Returns the altitude (meters above sea level).

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

### QGeoCoordinate

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.

### qreal

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.

### qreal

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.

### bool

Returns true if the type() is Coordinate2D or Coordinate3D.

### double

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.

### double

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.

### bool

Returns true if the latitude, longitude or altitude of this coordinate are not the same as those of other.

### QGeoCoordinate &

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

### bool

Returns true if the latitude, longitude and altitude of this coordinate are the same as those of other.

The longitude will be ignored if the latitude is +/- 90 degrees.

### void

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.

### void

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.

### QString

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:

format value Returned string Degrees -27.46758{0xB0}, 153.02789{0xB0}, 28.1m DegreesWithHemisphere 27.46758{0xB0} S, 153.02789{0xB0} E, 28.1m DegreesMinutes -27{0xB0} 28.054', 153{0xB0} 1.673', 28.1m DegreesMinutesWithHemisphere 27{0xB0} 28.054 S', 153{0xB0} 1.673' E, 28.1m DegreesMinutesSeconds -27{0xB0} 28' 3.2", 153\unicode{0xB0} 1' 40.4", 28.1m DegreesMinutesSecondsWithHemisphere 27{0xB0} 28' 3.2" S, 153\unicode{0xB0} 1' 40.4" E, 28.1m

The altitude field is omitted if no altitude is set.

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

### CoordinateType

Returns the type of this coordinate.

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy

Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia. Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.