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.