geoCoordinate QML Value Type
El tipo «geoCoordinate» representa y almacena una posición geográfica. Más información...
| Import Statement: | import QtPositioning |
Propiedades
Métodos
- geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
- real azimuthTo(geoCoordinate other)
- real distanceTo(geoCoordinate other)
Descripción detallada
Este tipo es una representación QML de QGeoCoordinate y representa una posición geográfica mediante los atributos latitude, longitude y altitude. El atributo latitude especifica el número de grados decimales por encima y por debajo del ecuador. Una latitud positiva indica el hemisferio norte y una latitud negativa indica el hemisferio sur. El atributo longitude especifica el número de grados decimales al este y al oeste. Una longitud positiva indica el hemisferio oriental y una longitud negativa indica el hemisferio occidental. El atributo altitude especifica el número de metros sobre el nivel del mar. En conjunto, estos atributos especifican una posición tridimensional en cualquier punto de la superficie terrestre o cerca de ella.
El atributo « isValid » se puede utilizar para comprobar si una coordenada es válida. Una coordenada se considera válida si tiene una latitud y una longitud válidas. No es necesario que la altitud sea válida. La latitud debe estar comprendida entre -90 y 90, ambos inclusive, y la longitud entre -180 y 180, ambos inclusive.
El tipo «geoCoordinate» es utilizado por muchos otros tipos del módulo « Qt Location » para especificar la posición de un objeto en un mapa, la posición actual de un dispositivo y muchas otras tareas. También cuenta con una serie de importantes métodos de utilidad que simplifican cálculos que, de otro modo, serían complejos, como « atDistanceAndAzimuth()».
Precisión
Los atributos de latitud, longitud y altitud almacenados en el tipo geoCoordinate se representan como valores de tipo «double», lo que les confiere una precisión de aproximadamente 16 dígitos decimales, suficiente para especificar micrómetros. Los cálculos realizados en los métodos de geoCoordinate, como azimuthTo() y distanceTo(), también utilizan valores de tipo «double» para todos los valores intermedios, pero las imprecisiones inherentes a su modelo esférico de la Tierra determinan la magnitud del error en el resultado.
Ejemplo de uso
Para crear un geoCoordinate, utilice uno de los métodos que se describen a continuación. En todos los casos, especificar el atributo ` altitude ` es opcional.
Para crear un valor geoCoordinate, utiliza la función QtPositioning.coordinate():
import QtPositioning
Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }o como componentes independientes « latitude », « longitude » y « altitude »:
Location {
coordinate {
latitude: -27.5
longitude: 153.1
}
}Al integrar con C++, ten en cuenta que cualquier valor de ` QGeoCoordinate ` pasado a QML desde C++ se convierte automáticamente en un valor de `geoCoordinate`, y viceversa.
Documentación de propiedades
altitude : real
Esta propiedad contiene el valor de la altitud (metros sobre el nivel del mar). Si no se ha establecido esta propiedad, su valor por defecto es NaN.
Para obtener más información, consulta la propiedad « QGeoCoordinate::altitude ».
isValid : bool
Esta propiedad indica la validez actual de la coordenada. Las coordenadas se consideran válidas si se han establecido con una latitud y una longitud válidas (no es necesario indicar la altitud).
Para que se consideren válidas, la latitud debe estar comprendida entre -90 y 90, ambos inclusive, y la longitud debe estar comprendida entre -180 y 180, ambos inclusive.
Esta es una propiedad de solo lectura.
latitude : real
Esta propiedad contiene el valor de la latitud de la posición geográfica (en grados decimales). Una latitud positiva indica el hemisferio norte, mientras que una latitud negativa indica el hemisferio sur. Si no se ha establecido esta propiedad, su valor por defecto es NaN.
Para obtener más información, consulta la propiedad « QGeoCoordinate::latitude ».
longitude : real
Esta propiedad contiene el valor de la longitud de la posición geográfica (en grados decimales). Una longitud positiva indica el hemisferio oriental, mientras que una longitud negativa indica el hemisferio occidental. Si no se ha establecido el valor de esta propiedad, su valor por defecto es NaN.
Para obtener más detalles, consulta la propiedad ` QGeoCoordinate::longitude `.
Documentación de métodos
geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
Devuelve la coordenada a la que se llega tras recorrer distance metros desde esta coordenada a azimuth grados a lo largo de un círculo máximo.
Para realizar este cálculo, se parte de la hipótesis de que la Tierra es esférica.
real azimuthTo(geoCoordinate other)
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.
Para realizar este cálculo, se parte de la hipótesis de que la Tierra es esférica.
real distanceTo(geoCoordinate other)
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.
© 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.