QML PositionSource Element

The PositionSource element allows you to get information about your current position. More...

List of all members, including inherited members

Properties

active : bool
nmeaSource : url
position : Position
positioningMethod : enumeration
updateInterval : bool

Signals

positionChanged

Methods

start
stop
update

Detailed Description

The PositionSource element allows you to get information about your current position. You can receive information about things such as latitude, longitude, altitude, and speed. This element is part of the QtMobility.location 1.1 module.

Support for location sources are platform dependant. When declaring a PositionSource element, a default PositionSource source shall be created. Supported positioning methods are held in positioningMethod. As a development convenience, one may also set data file as a source (NMEA format). Location updates are not necessarily started automatically upon element declaration, see start stop active and update.

Here is very simple example QML to illustrate the usage:

 import Qt 4.7
 import QtMobility.location 1.1

 Rectangle {
         id: page
         width: 350
         height: 350
         PositionSource {
             id: positionSource
             updateInterval: 1000
             active: true
             // nmeaSource: "nmealog.txt"
         }
         Column {
             Text {text: "<==== PositionSource ====>"}
             Text {text: "positioningMethod: "  + printableMethod(positionSource.positioningMethod)}
             Text {text: "nmeaSource: "         + positionSource.nmeaSource}
             Text {text: "updateInterval: "     + positionSource.updateInterval}
             Text {text: "active: "     + positionSource.active}
             Text {text: "<==== Position ====>"}
             Text {text: "latitude: "   + positionSource.position.coordinate.latitude}
             Text {text: "longitude: "   + positionSource.position.coordinate.longitude}
             Text {text: "altitude: "   + positionSource.position.coordinate.altitude}
             Text {text: "speed: " + positionSource.position.speed}
             Text {text: "timestamp: "  + positionSource.position.timestamp}
             Text {text: "altitudeValid: "  + positionSource.position.altitudeValid}
             Text {text: "longitudeValid: "  + positionSource.position.longitudeValid}
             Text {text: "latitudeValid: "  + positionSource.position.latitudeValid}
             Text {text: "speedValid: "     + positionSource.position.speedValid}
         }
         function printableMethod(method) {
             if (method == PositionSource.SatellitePositioningMethod)
                 return "Satellite";
             else if (method == PositionSource.NoPositioningMethod)
                 return "Not available"
             else if (method == PositionSource.NonSatellitePositioningMethod)
                 return "Non-satellite"
             else if (method == PositionSource.AllPositioningMethods)
                 return "All/multiple"
             return "source error";
         }
     }

Property Documentation

read-onlyactive : bool

This property indicates whether the position source is (/should be) active. Setting this property to false equals calling stop, and setting this property true equals calling start.