|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-DF756D6C-1E03-4EC0-B074-09611D122359" xml:lang="en"><title>Storing |
|
10 location information on a mobile device</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
|
11 <p><xref href="GUID-BC8D1F02-3FBB-406A-80CE-5836E61EBD82.dita">Location information</xref> may |
|
12 be stored as database entries called <i>landmarks</i> that contain at least |
|
13 a name and a location.</p> |
|
14 <p>Typical use cases include:</p> |
|
15 <ul> |
|
16 <li><p>Sending location information that is stored according to |
|
17 the World Geodetic System (WGS 84) to another device.</p></li> |
|
18 <li><p>Finding sites within a set distance of a stored point.</p> |
|
19 </li> |
|
20 </ul> |
|
21 <note> |
|
22 <p>The SDK does not include a map API, and therefore you must use a third |
|
23 party API to display the location information you receive on a map. <draft-comment time="2009-04-21T13:48">Does this also apply to S60 5th Edition?</draft-comment></p> |
|
24 </note> |
|
25 <section id="GUID-10327A77-B899-4F7F-9F12-094855387BAB"><title>Saving location |
|
26 information on a mobile device</title> |
|
27 <p>To store location information on your mobile device:</p> |
|
28 <ol> |
|
29 <li id="GUID-820AF19E-FD11-46E6-A865-6CFF62AD5508"><p>Make use of |
|
30 the methods of the Landmarks API when constructing |
|
31 your application.</p> |
|
32 <itemgroup> |
|
33 <p>The <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCPosLandmarkDatabase.html" format="application/java-archive"><codeph>CPosLandmarkDatabase</codeph></xref> class is used for accessing the database with the landmarks |
|
34 information and the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCPosLandmark.html" format="application/java-archive"><codeph>CPosLandmark</codeph></xref> class |
|
35 contains the location information.</p> |
|
36 <p>For detailed information on how to do this, see:</p> |
|
37 <ul> |
|
38 <li><p>Using landmarks database for |
|
39 a discussion of how to start accessing the database with the location information, |
|
40 including a structure diagram.</p></li> |
|
41 <li><p>Managing landmarks for |
|
42 code samples of opening, editing, and adding location information to a database</p> |
|
43 </li> |
|
44 <li><p>Listening to database events for |
|
45 possible events type passed to your application and code samples for implementing |
|
46 a listener</p> |
|
47 <itemgroup> |
|
48 <p>The TPosLmEvent class |
|
49 is used in listening for events.</p> |
|
50 </itemgroup> |
|
51 </li> |
|
52 </ul> |
|
53 </itemgroup> |
|
54 </li> |
|
55 <li id="GUID-8B69F55D-48B1-469B-83CA-31F0353DCBF0"><p>Make sure <codeph>eposlandmarks.lib</codeph> is |
|
56 accessible to your linker when compiling your application by including it |
|
57 in your .mmp file or by editing the project properties in your IDE, depending |
|
58 on your build environment.</p></li> |
|
59 <li id="GUID-09A43DDB-5BA1-470D-B5A3-5084D2BA124A"><p>Make sure |
|
60 you have the correct capabilities information set for your application, depending |
|
61 on your application you may need <codeph>LocalServices</codeph>, <codeph>NetworkServices</codeph>, <codeph>ReadDeviceData</codeph>, <codeph>ReadUserData</codeph>, <codeph>WriteDeviceData</codeph>, and <codeph>WriteUserData</codeph>.</p> |
|
62 </li> |
|
63 </ol> |
|
64 </section> |
|
65 <section id="GUID-8D41C21E-0334-4679-B4D2-709B96C34076"><title>Additional information |
|
66 on storing location information</title> |
|
67 <p>For more information see, <draft-comment time="2007-10-01T13:49">Question |
|
68 for the reviewers: Is there anything else that we could add here?</draft-comment></p> |
|
69 <ul> |
|
70 <li><p>API description for a description |
|
71 of the API and its class structure</p></li> |
|
72 <li><p>Using the Landmarks API for a |
|
73 general overview on how to create applications using the API</p></li> |
|
74 <li><p>For a reference example on searching and manipulating the |
|
75 information in the location database, see <codeph>LocationLandmarksRefAppForS60</codeph> in |
|
76 the SDK (<codeph><SDK installation directory>\S60CppExamples\</codeph>)</p> |
|
77 </li> |
|
78 <li><p>For a reference example on how to use common UI components |
|
79 to work with landmark data, see <codeph>LocationLandmarksUIRefApp</codeph> in |
|
80 the SDK (<codeph><SDK installation directory>\S60CppExamples\AutoAdaptedToTouchEx\</codeph>)</p> |
|
81 </li> |
|
82 </ul> |
|
83 </section> |
|
84 <section id="GUID-987E85BE-B14B-4248-853F-F7BC5EF48BE7"><title>Related Symbian |
|
85 APIs</title> |
|
86 <p>The Symbian platform also offers the following related |
|
87 APIs:</p> |
|
88 <ul> |
|
89 <li><p>Landmarks API for accessing |
|
90 the database</p></li> |
|
91 <li><p>Landmarks Database |
|
92 Management API for creating and deleting databases</p></li> |
|
93 <li><p>Landmarks Search API for |
|
94 allowing mobile devices users to search the database</p></li> |
|
95 <li><p>Landmarks UI Add/Edit API for |
|
96 allowing mobile device users to add and edit landmarks</p></li> |
|
97 <li><p>Landmarks UI Selector API for |
|
98 displaying and selecting landmarks</p></li> |
|
99 <li><p>Location Acquisition API for |
|
100 finding the location of a mobile device</p></li> |
|
101 <li><p><xref href="GUID-02EE9C85-5942-40F7-BF60-B5D8B04B9AA6.dita#GUID-02EE9C85-5942-40F7-BF60-B5D8B04B9AA6/GUID-15C32932-3088-4FC9-BE83-2EC00FCEB694">Communication</xref> for |
|
102 sending location information to other devices</p></li> |
|
103 </ul> |
|
104 </section> |
|
105 </conbody></concept> |