geoCoordinate QML Value Type

El tipo geoCoordinate representa y almacena una posición geográfica. Más...

Propiedades

• altitude : real
• isValid : bool
• latitude : real
• longitude : real

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 en forma de 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. Juntos, estos atributos especifican una posición tridimensional en cualquier lugar de la superficie terrestre o cerca de ella.

El atributo isValid puede utilizarse para comprobar si una coordenada es válida. Una coordenada se considera válida si tiene una latitud y longitud válidas. No se requiere una altitud 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 en el 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 cuentan con una serie de importantes métodos de utilidad que simplifican el uso de cálculos que de otro modo serían complejos, como atDistanceAndAzimuth().

Precisión

Los atributos de latitud, longitud y altitud almacenados en el tipo de geoCoordenada se representan como dobles, lo que les confiere aproximadamente 16 dígitos decimales de precisión, suficientes para especificar micrómetros. Los cálculos realizados en los métodos de geoCoordinate como azimuthTo() y distanceTo() también utilizan dobles para todos los valores intermedios, pero las imprecisiones inherentes a su modelo esférico de la Tierra dominan la cantidad de error en su salida.

Ejemplo de uso

Para crear una geoCoordenada utilice uno de los métodos descritos a continuación. En todos los casos, la especificación del atributo altitude es opcional.

Para crear un valor de geoCoordenada, utilice la función QtPositioning.coordinate():

import QtPositioning

Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }

o como componentes separados latitude, longitude y altitude:

Location {
    coordinate {
        latitude: -27.5
        longitude: 153.1
    }
}

Cuando se integre con C++, tenga en cuenta que cualquier valor QGeoCoordinate pasado a QML desde C++ se convierte automáticamente en un valor geoCoordinate, y viceversa.

Documentación de propiedades

altitude : real

Esta propiedad contiene el valor de la altitud (metros sobre el nivel del mar). Si la propiedad no ha sido establecida, su valor por defecto es NaN.

Para más detalles consulte la propiedad QGeoCoordinate::altitude

isValid : bool

Esta propiedad contiene la validez actual de la coordenada. Las coordenadas se consideran válidas si se han establecido con una latitud y longitud válidas (la altitud no es necesaria).

La latitud debe estar entre -90 y 90 inclusive para ser considerada válida, y la longitud debe estar entre -180 y 180 inclusive para ser considerada válida.

Esta propiedad es de sólo lectura.

latitude : real

Esta propiedad contiene el valor de la latitud de la posición geográfica (grados decimales). Una latitud positiva indica el Hemisferio Norte, y una latitud negativa indica el Hemisferio Sur. Si la propiedad no ha sido establecida, su valor por defecto es NaN.

Para más detalles consulte la propiedad QGeoCoordinate::latitude

longitude : real

Esta propiedad contiene el valor de la longitud de la posición geográfica (grados decimales). Una longitud positiva indica el Hemisferio Oriental, y una longitud negativa indica el Hemisferio Occidental. Si la propiedad no ha sido establecida, su valor por defecto es NaN.

Para más detalles consulte la propiedad QGeoCoordinate::longitude

Documentación del método

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

Devuelve la coordenada que se alcanza viajando distance metros desde esta coordenada a azimuth grados a lo largo de un gran círculo.

A efectos de este cálculo, se supone que la Tierra es esférica.

real azimuthTo(geoCoordinate other)

Devuelve el acimut (o rumbo) en grados desde esta coordenada a la coordenada especificada por other. La altitud no se utiliza en el cálculo.

Se supone que la Tierra es esférica a efectos de este cálculo.

real distanceTo(geoCoordinate other)

Devuelve la distancia (en metros) desde esta coordenada a la coordenada especificada por other. La altitud no se utiliza en el cálculo.

Este cálculo devuelve la distancia ortodrómica entre las dos coordenadas, suponiendo que la Tierra es esférica a efectos de este cálculo.