En esta página

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)
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()».

ConstanteValorDescripción
QGeoCoordinate::Degrees0Devuelve una representación en cadena de las coordenadas en formato de grados decimales.
QGeoCoordinate::DegreesWithHemisphere1Devuelve 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::DegreesMinutes2Devuelve una representación en cadena de las coordenadas en formato de grados y minutos.
QGeoCoordinate::DegreesMinutesWithHemisphere3Devuelve 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::DegreesMinutesSeconds4Devuelve una representación en cadena de las coordenadas en formato grados-minutos-segundos.
QGeoCoordinate::DegreesMinutesSecondsWithHemisphere5Devuelve 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.

ConstanteValorDescripción
QGeoCoordinate::InvalidCoordinate0Una coordenada no válida. Una coordenada no es válida si sus valores de latitud o longitud no son válidos.
QGeoCoordinate::Coordinate2D1Una coordenada con valores válidos de latitud y longitud.
QGeoCoordinate::Coordinate3D2Una 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 valorCadena devuelta
Degrees-27,46758°, 153,02789°, 28,1 m
DegreesWithHemisphere27,46758° S, 153,02789° E, 28,1 m
DegreesMinutes-27° 28,054', 153° 1,673', 28,1 m
DegreesMinutesWithHemisphere27° 28,054' S, 153° 1,673' E, 28,1 m
DegreesMinutesSeconds-27° 28' 3,2", 153° 1' 40,4", 28,1 m
DegreesMinutesSecondsWithHemisphere27° 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.