En esta página

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...

Import Statement: import QtPositioning

Propiedades

Descripción detallada

El tipo Posición contiene valores relacionados con la ubicación geográfica, como coordinate (longitud, latitud y altitud), la timestamp fecha en que se obtuvo la Posición, la speed en ese momento y la precisión de los datos.

Principalmente, se utiliza en la propiedad position de un PositionSource, como la unidad básica de datos disponibles de la fuente de datos de localización del sistema.

No todas las propiedades de un objeto Posición son necesariamente válidas o están disponibles (por ejemplo, la latitud y la longitud pueden ser válidas, pero la actualización de la velocidad no se ha recibido o configurado manualmente). Por ello, se dispone de las correspondientes propiedades "válidas" (por ejemplo coordinate y 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 sólo lectura y sólo pueden ser producidos por un PositionSource.

Ejemplo de uso

Véase el ejemplo dado 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 esos datos se han recibido o no, ya que cada actualización no contiene 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 sólo 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 desde el norte verdadero.

Es una propiedad de sólo lectura.

Esta propiedad se introdujo en Qt Positioning 5.3.

Véase también directionValid.

directionAccuracy : double [since Qt Positioning 6.3]

Esta propiedad contiene la precisión de direction en grados. Esta propiedad sólo es válida para Android y macOS/iOS. Consulte la documentación de QGeoPositionInfo::Attribute para más detalles.

Esta propiedad se introdujo en Qt Positioning 6.3.

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 esos datos se han recibido o no, ya que cada actualización no contiene necesariamente todos los datos).

Esta propiedad se introdujo en Qt Positioning 5.3.

Véase también direction.

horizontalAccuracy : real

Esta propiedad contiene 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 esos datos se han recibido o no, ya que cada actualización no contiene 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 esos datos se han recibido o no, ya que cada actualización no contiene 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 esos datos se han recibido o no, ya que cada actualización no contiene necesariamente todos los datos).

Véase también coordinate.

magneticVariation : double [since Qt Positioning 5.4]

Esta propiedad contiene el ángulo entre la componente horizontal del campo magnético y el norte verdadero, en grados. También se conoce como declinación magnética. Un valor positivo indica una dirección hacia la derecha desde el norte verdadero y un valor negativo indica una dirección hacia la izquierda.

Es una propiedad de sólo 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 esos datos se han recibido o no, ya que cada actualización no contiene 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 (groundpeed, metros / segundo).

Es una propiedad de sólo lectura.

Ver también speedValid y coordinate.

speedValid : bool

Esta propiedad es verdadera si se ha establecido speed (para indicar si esos datos se han recibido o no, ya que cada actualización no contiene necesariamente todos los datos).

Véase también speed.

timestamp : date

Esta propiedad contiene la fecha y hora en que se recibió esta posición. Si la propiedad no se ha establecido, no es válida.

Es una propiedad de sólo lectura.

verticalAccuracy : real

Esta propiedad contiene 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 esos datos se han recibido o no, ya que cada actualización no contiene 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 sólo lectura.

Esta propiedad se introdujo en Qt Positioning 5.3.

Véase también verticalSpeedValid.

verticalSpeedValid : bool [since Qt Positioning 5.3]

Esta propiedad es verdadera si se ha establecido verticalSpeed (para indicar si esos datos se han recibido o no, ya que cada actualización no contiene 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.