MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML Position Element

The Position element holds various positional data, such as coordinate (longitude, latitude, altitude) and speed. More...

This element was introduced in Mobility 1.2.

Properties

Detailed Description

The Position element holds various positional data, such as coordinate, (longitude, latitude, and altitude) and speed, as well as timestamp.

Not all of these are always available (e.g. latitude and longitude may be valid, but speed update has not been received or set manually), and hence there are corresponding validity attributes which can be used when writing applications.

At the time being the Position element is a read-only element (meaning it does not have exposed write accessors), primarily used by PositionSource.

The Position element is part of the QtMobility.location 1.1 module.

See also PositionSource and Coordinate.

Property Documentation

altitudeValid : bool

This property is true if coordinate's altitude has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also coordinate.


coordinate : Coordinate

This property holds the latitude, longitude, and altitude value of the Position.

Note: due to its inherent changing nature, the coordinateChanged() - signal is emitted also when the values of the coordinate changes, which enables easier data binding to Coordinate element instead of directly connecting to e.g. its latitude and longitude.

This property group was introduced in Mobility 1.2.

See also longitudeValid, latitudeValid, and altitudeValid.


horizontalAccuracy : qreal

This property holds the horizontal accuracy of the coordinate (in meters).

This property group was introduced in Mobility 1.2.

See also horizontalAccuracyValid and coordinate.


horizontalAccuracyValid : bool

This property is true if horizontalAccuracy has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also horizontalAccuracy.


latitudeValid : bool

This property is true if coordinate's latitude has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also coordinate.


longitudeValid : bool

This property is true if coordinate's longitude has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also coordinate.


speed : double

This property holds the value of speed (groundspeed, metres / second). Currently a read-only property.

This property group was introduced in Mobility 1.2.

See also speedValid and coordinate.


speedValid : bool

This property is true if speed has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also speed.


timestamp : date

This property holds the timestamp when this position was received. If the property has not been set, it is invalid.

This property group was introduced in Mobility 1.2.


verticalAccuracy : qreal

This property holds the vertical accuracy of the coordinate (in meters).

This property group was introduced in Mobility 1.2.

See also verticalAccuracyValid and coordinate.


verticalAccuracyValid : bool

This property is true if verticalAccuracy has been set (to indicate whether that data has been received or not, as every update does not necessarily contain all data).

This property group was introduced in Mobility 1.2.

See also verticalAccuracy.