Returned +location information

The ReturnValue property returned by a synchronous GetLocation call +and by callback for +an asynchronous GetLocation or Trace call +is an object containing the requested device location information. Each property +in the object corresponds to one kind of location information.

The exact set of properties included in the ReturnValue object +depends on the criteria defined +for the GetLocation or Trace call +and on the capabilities of the positioning system that provides the location +information for the mobile device. If a particular piece of location information +cannot be retrieved by the positioning system, the property for that information +is not included in the ReturnValue object. For example, +if basic location information is requested, the ReturnValue object +only contains properties for longitude, latitude, and altitude; no other location +information is returned. Similarly, if the positioning system used by the +S60 device cannot provide satellite information, the SatelliteNumView and SatelliteNumViewUsed properties +are not included in ReturnValue.

The WGS +84 datum is used to reference coordinates. The representation is +in decimal degrees.

The following table describes the location information returned by a GetLocation or Trace call.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

**Table:** ReturnValue properties +for location information
+ Property +	+ Description +	+ Value type +	+ Location information type +
+ `Longitude` +	+ Longitude estimate in degrees. The value range is [+180, -180]. +	+ number +	+ Basic or Generic +
+ `Latitude` +	+ Latitude estimate in degrees. The value range is [+90, -90]. +	+ number +	+ Basic or Generic +
+ `Altitude` +	+ Elevation estimate in meters relative to the WGS 84 datum. +	+ number +	+ Basic or Generic +
+ `SatelliteNumView` +	+ Number of satellites currently in view. +	+ number +	+ Generic +
+ `SatelliteNumViewUsed` +	+ Number of satellites used to obtain the location fix. +	+ number +	+ Generic +
+ `HorizontalSpeed` +	+ Horizontal speed estimate in meters per second. This is the speed of +the device at the time the location fix was obtained. +	+ number +	+ Generic +
+ `HorizontalSpeedError` +	+ Horizontal speed error in meters per second. +	+ number +	+ Generic +
+ `TrueCourse` +	+ Current direction of movement in degrees in relation to true north. +	+ number +	+ Generic +
+ `TrueCourseError` +	+ `TrueCourse` error in degrees. +	+ number +	+ Generic +
+ `MagneticHeading` +	+ Current direction of movement in degrees in relation to magnetic north. +	+ number +	+ Generic +
+ `MagneticHeadingError` +	+ `MagneticHeading` error in degrees. +	+ number +	+ Generic +
+ `Heading` +	+ Current instantaneous direction of movement in degrees in relation to +true north. + +	+ number +	+ Generic +
+ `HeadingError` +	+ `Heading` error in degrees. +	+ number +	+ Generic +
+ `MagneticCourse` +	+ Current instantaneous direction of movement in degrees in relation to +magnetic north. + +	+ number +	+ Generic +
+ `MagneticCourseError` +	+ `MagneticCourse` error in degrees. +	+ number +	+ Generic +