--- a/Symbian3/PDK/Source/GUID-A996FAAF-DB18-4F78-A8DA-873ACD771560.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-A996FAAF-DB18-4F78-A8DA-873ACD771560.dita Tue Mar 30 11:56:28 2010 +0100
@@ -4,13 +4,15 @@
"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.
+ Nokia Corporation - initial contribution.
Contributors:
---> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-A996FAAF-DB18-4F78-A8DA-873ACD771560" xml:lang="en"><title>Finding
-the location of a mobile device</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
-<p>The Location
-Acquisition API allows applications to access the <xref href="GUID-BC8D1F02-3FBB-406A-80CE-5836E61EBD82.dita">location
-information</xref> of a mobile device regardless of the <xref href="GUID-647F0CA5-5568-4C72-9CB5-C8CBF09B4B4B.dita">location
+-->
+<!DOCTYPE concept
+ PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-A996FAAF-DB18-4F78-A8DA-873ACD771560" xml:lang="en"><title>Finding
+the location of a mobile device</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The Location Acquisition API allows applications to access the <xref href="GUID-BC8D1F02-3FBB-406A-80CE-5836E61EBD82.dita">location information</xref> of
+a mobile device regardless of the <xref href="GUID-647F0CA5-5568-4C72-9CB5-C8CBF09B4B4B.dita">location
technology</xref> used. </p>
<p>Typical use cases include:</p>
<ul>
@@ -19,8 +21,8 @@
<li><p>Finding the location of a mobile device by network based
positioning.</p></li>
<li><p>Basic calculations using location information such as distances,
-bearing, and timestamp (see <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTPosition.html" format="application/java-archive"><codeph>TPosition</codeph></xref> and Extended
-location information)</p></li>
+bearing, and timestamp (see <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTPosition.html" format="application/java-archive"><codeph>TPosition</codeph></xref> and
+Extended location information).</p></li>
</ul>
<p>Important implementation considerations include:</p>
<ul>
@@ -46,8 +48,7 @@
<p>To find the location of a mobile device:</p>
<ol>
<li id="GUID-21F99413-A2DC-4588-856B-292FF3C0F6D4"><p>Use the methods
-of the Location
-Acquisition API to construct your application. </p>
+of the Location Acquisition API to construct your application. </p>
<itemgroup>
<p>The <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classRPositionServer.html" format="application/java-archive"><codeph>RPositionServer</codeph></xref> and <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classRPositioner.html" format="application/java-archive"><codeph>RPositioner</codeph></xref> classes
are particularly relevant in getting the location of your device, which is
@@ -55,17 +56,15 @@
<p>For information on some detailed uses of the API, see the Location Acquisition
API Usage section for:</p>
<ul>
-<li><p> list of the steps required
-for finding the location of a mobile device in a basic use case</p></li>
-<li><p>how to obtain the current location estimate</p>
-</li>
-<li><p>how to obtain an extended location estimate,
-including information such as bearing, speed, and available satellites, which
-is not normally returned with the current location estimate</p></li>
-<li><p>how to obtain your last known position
-information, using cached information if available. This means
-that this method does not retrieve the location information from the underlying
-positioning methods.</p></li>
+<li><p>a list of the steps required for finding the location of
+a mobile device in a basic use case</p></li>
+<li><p>how to obtain the current location estimate</p></li>
+<li><p>how to obtain an extended location estimate, including information
+such as bearing, speed, and available satellites, which is not normally returned
+with the current location estimate</p></li>
+<li><p>how to obtain your last known position information, using
+cached information if available. This means that this method does not retrieve
+the location information from the underlying positioning methods.</p></li>
</ul>
</itemgroup>
</li>
@@ -83,28 +82,27 @@
on locating your device</title>
<p>For more information, see:</p>
<ul>
-<li><p>The purpose and general overview of
-the Location Acquisition API.</p></li>
-<li><p>description and class structure of
-the API.</p></li>
-<li><p>a general overview on how to create applications using
-the API.</p></li>
-<li><p>for an example of how to use the Location Acquisition API,
-see the <codeph>LocationRefAppForS60</codeph> in the SDK (<codeph><SDK
-installation directory>\S60CppExamples\AutoAdaptedToTouchEx</codeph>).</p>
-</li>
+<li><p>The purpose and general overview of the Location Acquisition
+API.</p></li>
+<li><p>The description and class structure of the API.</p></li>
+<li><p>A general overview on how to create applications using the
+API.</p></li>
+<li><p>The <codeph>LocationRefAppForS60</codeph> in the SDK (<codeph><SDK
+installation directory>\S60CppExamples\AutoAdaptedToTouchEx</codeph>), for
+an example of how to use the Location Acquisition API.</p></li>
</ul>
</section>
<section id="GUID-94FC6381-CDB3-4F70-B3F5-66D450F827EC"><title>Related APIs</title>
-<p>The Symbian platform also offers the following related
-services:</p>
+<p>The Symbian platform also offers the following related services:</p>
<ul>
-<li><p>EXIF API</p>
+<li><p><xref format="html" href="specs/guides/Exif_API_Specification/Exif_API_Specification.html" scope="external">EXIF
+API</xref></p>
<itemgroup>
<p>Allows you to include data, such as location information, in image files.</p>
</itemgroup>
</li>
-<li><p>Landmarks API</p>
+<li><p><xref format="html" href="specs/guides/Landmarks_API_Specification/Landmarks_API_Specification.html" scope="external">Landmarks
+API</xref></p>
<itemgroup>
<p>Allows you to <xref href="GUID-DF756D6C-1E03-4EC0-B074-09611D122359.dita">store
location information on your mobile device</xref>.</p>