Position QML Type
El tipo «Posición» contiene datos de posición en un momento determinado, como las coordenadas (longitud, latitud, altitud) y la velocidad. Más información...
| Import Statement: | import QtPositioning |
Propiedades
- altitudeValid : bool
- coordinate : coordinate
- direction : double
(since Qt Positioning 5.3) - directionAccuracy : double
(since Qt Positioning 6.3) - directionAccuracyValid : bool
(since Qt Positioning 6.3) - directionValid : bool
(since Qt Positioning 5.3) - horizontalAccuracy : real
- horizontalAccuracyValid : bool
- latitudeValid : bool
- longitudeValid : bool
- magneticVariation : double
(since Qt Positioning 5.4) - magneticVariationValid : bool
(since Qt Positioning 5.4) - speed : double
- speedValid : bool
- timestamp : date
- verticalAccuracy : real
- verticalAccuracyValid : bool
- verticalSpeed : double
(since Qt Positioning 5.3) - verticalSpeedValid : bool
(since Qt Positioning 5.3)
Descripción detallada
El tipo «Posición» contiene valores relacionados con la ubicación geográfica, como las coordenadas de una « coordinate » (longitud, latitud y altitud), la « timestamp » en la que se obtuvo la posición, la « speed » en ese momento y la precisión de los datos.
Se utiliza principalmente en la propiedad « position » de un « PositionSource », como unidad básica de los datos disponibles en la fuente de datos de ubicación del sistema.
No todas las propiedades de un objeto «Position» son necesariamente válidas o están disponibles (por ejemplo, la latitud y la longitud pueden ser válidas, pero es posible que no se haya recibido la actualización de la velocidad o que esta no se haya establecido manualmente). Como resultado, están disponibles las propiedades «válidas» correspondientes (por ejemplo, « coordinate », « longitudeValid », « latitudeValid », etc.) para discernir si los datos están disponibles y son válidos en esta actualización de posición.
Los objetos de posición son de solo lectura y solo pueden generarse mediante un PositionSource.
Ejemplo de uso
Consulte el ejemplo proporcionado para el tipo « PositionSource » o la aplicación de ejemplo «Satellite Info ».
Véase también « PositionSource » y « coordinate ».
Documentación de propiedades
altitudeValid : bool
Esta propiedad es verdadera si se ha establecido la altitud de la coordenada (para indicar si se han recibido o no esos datos, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también coordinate.
coordinate : coordinate
Esta propiedad contiene los valores de latitud, longitud y altitud de la posición.
Es una propiedad de solo lectura.
Véase también longitudeValid, latitudeValid y altitudeValid.
direction : double [since Qt Positioning 5.3]
Esta propiedad contiene el valor de la dirección de desplazamiento en grados con respecto al norte verdadero.
Es una propiedad de solo lectura.
Esta propiedad se introdujo en Qt Positioning 5.3.
Véase también directionValid.
directionAccuracy : double [since Qt Positioning 6.3]
Esta propiedad indica la precisión de la coordenada direction proporcionada, expresada en grados. Esta propiedad solo es válida para Android y macOS/iOS. Consulta la documentación de QGeoPositionInfo::Attribute para obtener más detalles.
Esta propiedad se introdujo en la versión 6.3 de Qt Positioning.
Véase también « direction » y « directionAccuracyValid ».
directionAccuracyValid : bool [since Qt Positioning 6.3]
Esta propiedad es « true » si se ha establecido « directionAccuracy ».
Esta propiedad se introdujo en Qt Positioning 6.3.
Véase también directionAccuracy.
directionValid : bool [since Qt Positioning 5.3]
Esta propiedad es verdadera si se ha establecido « direction » (para indicar si se han recibido o no esos datos, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Esta propiedad se introdujo en la versión 5.3 de Qt Positioning.
Véase también « direction ».
horizontalAccuracy : real
Esta propiedad indica la precisión horizontal de la coordenada (en metros).
Véase también horizontalAccuracyValid y coordinate.
horizontalAccuracyValid : bool
Esta propiedad es verdadera si se ha establecido « horizontalAccuracy » (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también horizontalAccuracy.
latitudeValid : bool
Esta propiedad es verdadera si se ha establecido la latitud de la coordenada (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también coordinate.
longitudeValid : bool
Esta propiedad es verdadera si se ha establecido la longitud de la coordenada (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también coordinate.
magneticVariation : double [since Qt Positioning 5.4]
Esta propiedad indica el ángulo, expresado en grados, entre la componente horizontal del campo magnético y el norte verdadero. También se conoce como declinación magnética. Un valor positivo indica una dirección en el sentido de las agujas del reloj a partir del norte verdadero, mientras que un valor negativo indica una dirección en sentido contrario a las agujas del reloj.
Es una propiedad de solo lectura.
Esta propiedad se introdujo en Qt Positioning 5.4.
Véase también magneticVariationValid.
magneticVariationValid : bool [since Qt Positioning 5.4]
Esta propiedad es verdadera si se ha establecido « magneticVariation » (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Esta propiedad se introdujo en Qt Positioning 5.4.
Véase también magneticVariation.
speed : double
Esta propiedad contiene el valor de la velocidad (velocidad respecto al suelo, metros por segundo).
Es una propiedad de solo lectura.
Véase también speedValid y coordinate.
speedValid : bool
Esta propiedad es verdadera si se ha establecido « speed » (para indicar si se han recibido o no esos datos, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también speed.
timestamp : date
Esta propiedad contiene la marca de tiempo en la que se recibió esta posición. Si la propiedad no se ha establecido, no es válida.
Es una propiedad de solo lectura.
verticalAccuracy : real
Esta propiedad indica la precisión vertical de la coordenada (en metros).
Véase también verticalAccuracyValid y coordinate.
verticalAccuracyValid : bool
Esta propiedad es verdadera si se ha establecido « verticalAccuracy » (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Véase también verticalAccuracy.
verticalSpeed : double [since Qt Positioning 5.3]
Esta propiedad contiene el valor de la velocidad vertical en metros por segundo.
Es una propiedad de solo lectura.
Esta propiedad se introdujo en la versión 5.3 de « Qt Positioning ».
Véase también verticalSpeedValid.
verticalSpeedValid : bool [since Qt Positioning 5.3]
Esta propiedad es verdadera si se ha establecido « verticalSpeed » (para indicar si se han recibido esos datos o no, ya que no todas las actualizaciones contienen necesariamente todos los datos).
Esta propiedad se introdujo en Qt Positioning 5.3.
Véase también verticalSpeed.
© 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.