--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-AD7D9D39-6FF0-5811-9708-98538271BA0D.dita Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License
+"Eclipse Public License v1.0" which accompanies this distribution,
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+ Nokia Corporation - initial contribution.
+Contributors:
+-->
+<!DOCTYPE concept
+ PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-AD7D9D39-6FF0-5811-9708-98538271BA0D" xml:lang="en"><title>Position
+data</title><shortdesc>This document describes the basic and extended classes that hold
+position data. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section><title>Purpose</title> <p>This document describes how position data
+is represented within the <xref href="GUID-ABC01315-D65D-55EA-9D42-4DE6384D517D.dita">position
+data classes</xref>. </p> </section>
+<section><title>Values and co-ordinates</title> <ul>
+<li id="GUID-23C5B7B1-8F7E-5E67-BFC5-8B6ADF2EC263"><p>The World Geodetic System
+reference datum (WGS 84) is used by LBS. This is a global co-ordinate system
+in which co-ordinates are expressed as latitude and longitude in degrees and
+altitude in metres above the reference datum. In WGS 84, latitude values have
+the range (-90 <= Lat <= +90) and longitude values have the range (-180
+<= Long < +180). </p> </li>
+<li id="GUID-3F2BFE0F-29A1-516D-A27B-35298AD35FC8"><p>In LBS, latitude and
+longitude are held as <codeph>TReal64</codeph> values and altitude is held
+as a <codeph>TReal32</codeph> value. </p> </li>
+<li id="GUID-EB9BEB2B-2CC2-5C70-9A88-4C9D80F42D0A"><p>Both horizontal and
+vertical accuracy are held as <codeph>TReal32</codeph> values and represent
+a possible error values in metres. </p> </li>
+<li id="GUID-9909202F-8C8C-5EAA-814F-B9760CE63F6C"><p>Bearings and headings
+are held as <codeph>TReal32</codeph> values and represent a direction in degrees.
+Bearing and heading accuracies are also held as <codeph>TReal32</codeph> values
+and represent a possible error value in degrees. </p> </li>
+</ul> </section>
+<section><title>Co-ordinate adjustment</title> <p>The <xref href="GUID-DDCBA817-9D88-3332-ABD3-1DDC6E397851.dita"><apiname>TCoordinate</apiname></xref> base
+class holds the latitude, longitude and altitude of a position. If an application
+attempts to assign values that are outside of the ranges specified by WGS
+84 to an instance of a <codeph>TCoordinate</codeph> class then the values
+are adjusted to lie within the correct interval. </p> </section>
+<section><title>Unassigned values</title> <p>In some situations, one of the
+position co-ordinates, typically altitude may not be known. This is usually
+because the positioning module that was used to obtain the location fix was
+unable to obtain data for that co-ordinate. Where LBS cannot assign a value
+to a co-ordinate value, the value "Not a Number" (NaN) is assigned to it.
+Applications must test for this situation by calling <xref href="GUID-1DB7AE7A-A505-3530-AC2B-EBAEFCD3F36A.dita#GUID-1DB7AE7A-A505-3530-AC2B-EBAEFCD3F36A/GUID-79B7EC5D-973E-3B91-91C4-48F10FC0038D"><apiname>Math::IsNaN()</apiname></xref> on
+each returned co-ordinate value before using it in a calculation. </p> </section>
+</conbody><related-links>
+<link href="GUID-70E1117B-17F0-5CF4-A5D0-35D3BEBB0FEA.dita"><linktext>Position
+Area Data Classes</linktext></link>
+<link href="GUID-ACD9E338-DF75-5811-B696-C3900B498218.dita"><linktext>Privacy Requester
+Classes</linktext></link>
+</related-links></concept>
\ No newline at end of file