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