QGeoCoordinate Class
La clase QGeoCoordinate define una posición geográfica en la superficie de la Tierra. Más información...
| Encabezado: | #include <QGeoCoordinate> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
Tipos públicos
| enum | CoordinateFormat { Degrees, DegreesWithHemisphere, DegreesMinutes, DegreesMinutesWithHemisphere, DegreesMinutesSeconds, DegreesMinutesSecondsWithHemisphere } |
| enum | CoordinateType { InvalidCoordinate, Coordinate2D, Coordinate3D } |
Propiedades
Funciones públicas
| QGeoCoordinate() | |
| QGeoCoordinate(double latitude, double longitude) | |
| QGeoCoordinate(double latitude, double longitude, double altitude) | |
| QGeoCoordinate(const QGeoCoordinate &other) | |
(since 6.2) | QGeoCoordinate(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 |
| void | setAltitude(double altitude) |
| void | setLatitude(double latitude) |
| void | setLongitude(double longitude) |
(since 6.2) void | swap(QGeoCoordinate &other) |
| QString | toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const |
| QGeoCoordinate::CoordinateType | type() const |
(since 6.2) QGeoCoordinate & | operator=(QGeoCoordinate &&other) |
| QGeoCoordinate & | operator=(const QGeoCoordinate &other) |
Personas no afiliadas relacionadas
| bool | operator!=(const QGeoCoordinate &lhs, const QGeoCoordinate &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoCoordinate &coordinate) |
| bool | operator==(const QGeoCoordinate &lhs, const QGeoCoordinate &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoCoordinate &coordinate) |
Descripción detallada
Una QGeoCoordinate se define por la latitud, la longitud y, opcionalmente, la altitud.
Utiliza type() para determinar si una coordenada es una coordenada 2D (que solo tiene latitud y longitud) o una coordenada 3D (que tiene latitud, longitud y altitud). Utiliza distanceTo() y azimuthTo() para calcular la distancia y el rumbo entre coordenadas.
Los valores de las coordenadas deben especificarse utilizando el sistema de referencia WGS84. Para obtener más información sobre términos geográficos, consulta este artículo sobre coordenadas y otro sobre sistemas geodésicos, incluido el WGS84.
En este contexto, el azimut equivale a un rumbo de brújula basado en el norte verdadero.
También se puede acceder a esta clase en QML como geoCoordinate.
Documentación sobre los tipos de miembros
enum QGeoCoordinate::CoordinateFormat
Define las opciones de formato posibles para la función « toString()».
| Constante | Valor | Descripción |
|---|---|---|
QGeoCoordinate::Degrees | 0 | Devuelve una representación en cadena de las coordenadas en formato de grados decimales. |
QGeoCoordinate::DegreesWithHemisphere | 1 | Devuelve una representación en cadena de las coordenadas en formato de grados decimales, utilizando «N», «S», «E» o «W» para indicar los hemisferios de las coordenadas. |
QGeoCoordinate::DegreesMinutes | 2 | Devuelve una representación en cadena de las coordenadas en formato de grados y minutos. |
QGeoCoordinate::DegreesMinutesWithHemisphere | 3 | Devuelve una representación en cadena de las coordenadas en formato de grados y minutos, utilizando «N», «S», «E» o «W» para indicar los hemisferios de las coordenadas. |
QGeoCoordinate::DegreesMinutesSeconds | 4 | Devuelve una representación en cadena de las coordenadas en formato grados-minutos-segundos. |
QGeoCoordinate::DegreesMinutesSecondsWithHemisphere | 5 | Devuelve una representación en cadena de las coordenadas en formato grados-minutos-segundos, utilizando «N», «S», «E» o «W» para indicar los hemisferios de las coordenadas. |
Véase también toString().
enum QGeoCoordinate::CoordinateType
Define los tipos de una coordenada.
| Constante | Valor | Descripción |
|---|---|---|
QGeoCoordinate::InvalidCoordinate | 0 | Una coordenada no válida. Una coordenada no es válida si sus valores de latitud o longitud no son válidos. |
QGeoCoordinate::Coordinate2D | 1 | Una coordenada con valores válidos de latitud y longitud. |
QGeoCoordinate::Coordinate3D | 2 | Una coordenada con valores de latitud y longitud válidos, así como un valor de altitud. |
Documentación de propiedades
altitude : double
Esta propiedad contiene la altitud en metros sobre el nivel del mar.
La propiedad no está definida (qQNaN()) si no se ha establecido la altitud.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| double | altitude() const |
| void | setAltitude(double altitude) |
[read-only] isValid : bool
Esta propiedad indica la validez de esta coordenada geográfica.
La coordenada geográfica es válida si las propiedades longitude y latitude se han establecido en valores válidos.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| bool | isValid() const |
latitude : double
Esta propiedad contiene la latitud en grados decimales.
La propiedad no está definida (qQNaN()) si no se ha establecido la latitud. Una latitud positiva indica el hemisferio norte, y una latitud negativa indica el hemisferio sur. Al establecer la latitud, el nuevo valor debe estar en el formato de sistema de coordenadas WGS84.
Para que sea válida, la latitud debe estar comprendida entre -90 y 90, ambos inclusive.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| double | latitude() const |
| void | setLatitude(double latitude) |
longitude : double
Esta propiedad contiene la longitud en grados decimales.
La propiedad no está definida (qQNaN()) si no se ha establecido la longitud. Una longitud positiva indica el hemisferio oriental, mientras que una longitud negativa indica el hemisferio occidental. Al establecer la longitud, el nuevo valor debe estar en el formato de datum WGS84.
Para que sea válida, la longitud debe estar comprendida entre -180 y 180, ambos inclusive.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| double | longitude() const |
| void | setLongitude(double longitude) |
Documentación de las funciones miembro
QGeoCoordinate::QGeoCoordinate()
Crea una coordenada. La coordenada no será válida hasta que se hayan llamado a las funciones ` setLatitude()` y ` setLongitude()`.
QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)
Crea una coordenada con los valores proporcionados en « latitude » y « longitude ».
Si la latitud no está comprendida entre -90 y 90, ambos inclusive, o la longitud no está comprendida entre -180 y 180, ambos inclusive, no se establece ningún valor y el objeto ` type()` tendrá el valor ` QGeoCoordinate::InvalidCoordinate`.
Véase también isValid().
QGeoCoordinate::QGeoCoordinate(double latitude, double longitude, double altitude)
Crea una coordenada con los valores proporcionados: latitude, longitude y altitude.
Si la latitud no está comprendida entre -90 y 90, ambos inclusive, o la longitud no está comprendida entre -180 y 180, ambos inclusive, no se establece ninguno de los valores y type() será QGeoCoordinate::InvalidCoordinate.
Ten en cuenta que altitude especifica los metros sobre el nivel del mar.
Véase también isValid().
QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)
Crea una coordenada a partir del contenido de other.
[constexpr noexcept default, since 6.2] QGeoCoordinate::QGeoCoordinate(QGeoCoordinate &&other)
Crea una coordenada a partir de other.
Nota: El objeto QGeoCoordinate del que se ha realizado el desplazamiento solo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
[noexcept] QGeoCoordinate::~QGeoCoordinate()
Elimina el objeto de coordenadas.
double QGeoCoordinate::altitude() const
Devuelve la altitud (en metros sobre el nivel del mar).
El valor devuelto es indefinido si no se ha establecido la altitud.
Nota: Funcióngetter para la propiedad «altitude».
Véase también setAltitude() y type().
[invokable] QGeoCoordinate QGeoCoordinate::atDistanceAndAzimuth(qreal distance, qreal azimuth, qreal distanceUp = 0.0) const
Devuelve la coordenada a la que se llega tras recorrer distance metros desde la coordenada actual en azimuth (o rumbo) a lo largo de un círculo máximo. Para este cálculo se parte del supuesto de que la Tierra es esférica.
A la altitud se le sumarán « distanceUp ».
Devuelve una coordenada no válida si esta coordenada no es válida.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const
Devuelve el azimut (o rumbo) en grados desde esta coordenada hasta la coordenada especificada por other. La altitud no se tiene en cuenta en el cálculo.
El rumbo devuelto es el que va desde el origen hasta other a lo largo del círculo máximo entre ambas coordenadas. Para este cálculo se parte del supuesto de que la Tierra es esférica.
Devuelve 0 si el tipo de esta coordenada o el tipo de other es QGeoCoordinate::InvalidCoordinate.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const
Devuelve la distancia (en metros) desde esta coordenada hasta la coordenada especificada por other. La altitud no se tiene en cuenta en el cálculo.
Este cálculo devuelve la distancia ortodrómica entre las dos coordenadas, partiendo de la hipótesis de que la Tierra es esférica a efectos de este cálculo.
Devuelve 0 si el tipo de esta coordenada o el tipo de other es « QGeoCoordinate::InvalidCoordinate ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
bool QGeoCoordinate::isValid() const
Devuelve « true » si « longitude » y « latitude » son válidos.
Nota: Funcióngetter para la propiedad isValid.
double QGeoCoordinate::latitude() const
Devuelve la latitud, en grados decimales. El valor devuelto no está definido si no se ha establecido la latitud.
Una latitud positiva indica el hemisferio norte, y una latitud negativa indica el hemisferio sur.
Nota: Funcióngetter para la propiedad «latitude».
Véase también setLatitude() y type().
double QGeoCoordinate::longitude() const
Devuelve la longitud, en grados decimales. El valor devuelto es indefinido si no se ha establecido la longitud.
Una longitud positiva indica el hemisferio oriental, y una longitud negativa indica el hemisferio occidental.
Nota: Funcióngetter para la propiedad «longitude».
Véase también setLongitude() y type().
void QGeoCoordinate::setAltitude(double altitude)
Establece la altitud (metros sobre el nivel del mar) en altitude.
Nota: Funciónde asignación para la propiedad altitude.
Véase también altitude().
void QGeoCoordinate::setLatitude(double latitude)
Establece la latitud (en grados decimales) en latitude. El valor debe estar en el sistema de referencia WGS84.
Para que sea válida, la latitud debe estar comprendida entre -90 y 90, ambos inclusive.
Nota: Funciónde asignación para la propiedad latitude.
Véase también latitude().
void QGeoCoordinate::setLongitude(double longitude)
Establece la longitud (en grados decimales) en longitude. El valor debe estar en el sistema de referencia WGS84.
Para que sea válida, la longitud debe estar comprendida entre -180 y 180, ambos incluidos.
Nota: Funciónde asignación para la propiedad longitude.
Véase también longitude().
[noexcept, since 6.2] void QGeoCoordinate::swap(QGeoCoordinate &other)
Intercambia esta coordenada con other. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.2.
[invokable] QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const
Devuelve esta coordenada como una cadena en el formato especificado format.
Por ejemplo, si esta coordenada tiene una latitud de -27,46758, una longitud de 153,027892 y una altitud de 28,1, estas son las cadenas que se devuelven en función de format:
| format valor | Cadena devuelta |
|---|---|
| Degrees | -27,46758°, 153,02789°, 28,1 m |
| DegreesWithHemisphere | 27,46758° S, 153,02789° E, 28,1 m |
| DegreesMinutes | -27° 28,054', 153° 1,673', 28,1 m |
| DegreesMinutesWithHemisphere | 27° 28,054' S, 153° 1,673' E, 28,1 m |
| DegreesMinutesSeconds | -27° 28' 3,2", 153° 1' 40,4", 28,1 m |
| DegreesMinutesSecondsWithHemisphere | 27° 28' 3,2" S, 153° 1' 40,4" E, 28,1 m |
El campo de altitud se omite si no se ha establecido ninguna altitud.
Si la coordenada no es válida, se devuelve una cadena vacía.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QGeoCoordinate::CoordinateType QGeoCoordinate::type() const
Devuelve el tipo de esta coordenada.
[noexcept, since 6.2] QGeoCoordinate &QGeoCoordinate::operator=(QGeoCoordinate &&other)
La operación «move-assign» asigna other a esta coordenada y devuelve una referencia a dicha coordenada.
Nota: El objeto ` QGeoCoordinate ` del que se ha realizado el traslado solo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.
Esta función se introdujo en Qt 6.2.
QGeoCoordinate &QGeoCoordinate::operator=(const QGeoCoordinate &other)
Asigna « other » a esta coordenada y devuelve una referencia a dicha coordenada.
Elementos no miembros relacionados
bool operator!=(const QGeoCoordinate &lhs, const QGeoCoordinate &rhs)
Devuelve ` true ` si la latitud, la longitud o la altitud de la coordenada ` lhs ` no coinciden con las de la coordenada ` rhs `. En caso contrario, devuelve ` false`.
QDataStream &operator<<(QDataStream &stream, const QGeoCoordinate &coordinate)
Escribe el objeto « coordinate » indicado en el objeto « stream » especificado.
Véase también Serialización detipos de datos de Qt.
bool operator==(const QGeoCoordinate &lhs, const QGeoCoordinate &rhs)
Devuelve « true » si la latitud, la longitud y la altitud de la coordenada lhs coinciden con las de la coordenada rhs. En caso contrario, devuelve « false ».
Se ignorará la longitud si la latitud es de +/- 90 grados.
QDataStream &operator>>(QDataStream &stream, QGeoCoordinate &coordinate)
Lee una coordenada del archivo especificado stream y la inserta en el archivo dado coordinate.
Véase también «Serialización detipos de datos de Qt».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.