2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
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 |
9 --> |
10 location information on a mobile device</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
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> |
11 <p><xref href="GUID-BC8D1F02-3FBB-406A-80CE-5836E61EBD82.dita">Location information</xref> may |
14 <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 |
15 be stored as database entries called <i>landmarks</i> that contain at least |
13 a name and a location.</p> |
16 a name and a location.</p> |
14 <p>Typical use cases include:</p> |
17 <p>Typical use cases include:</p> |
15 <ul> |
18 <ul> |
25 <section id="GUID-10327A77-B899-4F7F-9F12-094855387BAB"><title>Saving location |
28 <section id="GUID-10327A77-B899-4F7F-9F12-094855387BAB"><title>Saving location |
26 information on a mobile device</title> |
29 information on a mobile device</title> |
27 <p>To store location information on your mobile device:</p> |
30 <p>To store location information on your mobile device:</p> |
28 <ol> |
31 <ol> |
29 <li id="GUID-820AF19E-FD11-46E6-A865-6CFF62AD5508"><p>Make use of |
32 <li id="GUID-820AF19E-FD11-46E6-A865-6CFF62AD5508"><p>Make use of |
30 the methods of the Landmarks API when constructing |
33 the methods of the <xref href="jar:.jar!/public_specs/GuidesA/Landmarks_API_Specification/Landmarks_API_Specification.html" format="application/java-archive">Landmarks |
31 your application.</p> |
34 API</xref> <xref format="html" href="specs/guides/Landmarks_API_Specification/Landmarks_API_Specification.html" scope="external"/>when |
|
35 constructing your application.</p> |
32 <itemgroup> |
36 <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 |
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 |
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 |
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 |
35 contains the location information.</p> |
39 contains the location information.</p> |
36 <p>For detailed information on how to do this, see:</p> |
40 <p>For detailed information on how to do this, see:</p> |
37 <ul> |
41 <ul> |
38 <li><p>Using landmarks database for |
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 |
39 a discussion of how to start accessing the database with the location information, |
43 start accessing the database with the location information, including a structure |
40 including a structure diagram.</p></li> |
44 diagram.</p></li> |
41 <li><p>Managing landmarks for |
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 |
42 code samples of opening, editing, and adding location information to a database</p> |
46 location information to a database</p></li> |
43 </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 |
44 <li><p>Listening to database events for |
48 your application and code samples for implementing a listener</p> |
45 possible events type passed to your application and code samples for implementing |
|
46 a listener</p> |
|
47 <itemgroup> |
49 <itemgroup> |
48 <p>The TPosLmEvent class |
50 <p>The <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/structTPosLmEvent.html" format="application/java-archive">TPosLmEvent</xref> class |
49 is used in listening for events.</p> |
51 is used in listening for events.</p> |
50 </itemgroup> |
52 </itemgroup> |
51 </li> |
53 </li> |
52 </ul> |
54 </ul> |
53 </itemgroup> |
55 </itemgroup> |
65 <section id="GUID-8D41C21E-0334-4679-B4D2-709B96C34076"><title>Additional information |
67 <section id="GUID-8D41C21E-0334-4679-B4D2-709B96C34076"><title>Additional information |
66 on storing location information</title> |
68 on storing location information</title> |
67 <p>For more information see, <draft-comment time="2007-10-01T13:49">Question |
69 <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> |
70 for the reviewers: Is there anything else that we could add here?</draft-comment></p> |
69 <ul> |
71 <ul> |
70 <li><p>API description for a description |
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> |
71 of the API and its class structure</p></li> |
73 </li> |
72 <li><p>Using the Landmarks API for a |
74 <li><p><xref format="html" href="specs/guides/Landmarks_API_Specification/Landmarks_API_Specification.html" scope="external">Using |
73 general overview on how to create applications using the API</p></li> |
75 the Landmarks API</xref> for a general overview on how to create applications |
|
76 using the API</p></li> |
74 <li><p>For a reference example on searching and manipulating the |
77 <li><p>For a reference example on searching and manipulating the |
75 information in the location database, see <codeph>LocationLandmarksRefAppForS60</codeph> in |
78 information in the location database, see <codeph>LocationLandmarksRefAppForS60</codeph> in |
76 the SDK (<codeph><SDK installation directory>\S60CppExamples\</codeph>)</p> |
79 the SDK (<codeph><SDK installation directory>\S60CppExamples\</codeph>)</p> |
77 </li> |
80 </li> |
78 <li><p>For a reference example on how to use common UI components |
81 <li><p>For a reference example on how to use common UI components |
81 </li> |
84 </li> |
82 </ul> |
85 </ul> |
83 </section> |
86 </section> |
84 <section id="GUID-987E85BE-B14B-4248-853F-F7BC5EF48BE7"><title>Related Symbian |
87 <section id="GUID-987E85BE-B14B-4248-853F-F7BC5EF48BE7"><title>Related Symbian |
85 APIs</title> |
88 APIs</title> |
86 <p>The Symbian platform also offers the following related |
89 <p>The Symbian platform also offers the following related APIs:</p> |
87 APIs:</p> |
|
88 <ul> |
90 <ul> |
89 <li><p>Landmarks API for accessing |
91 <li><p><xref format="html" href="specs/guides/Landmarks_API_Specification/Landmarks_API_Specification.html" scope="external">Landmarks |
90 the database</p></li> |
92 API</xref> for accessing the database</p></li> |
91 <li><p>Landmarks Database |
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> |
92 Management API for creating and deleting databases</p></li> |
94 </li> |
93 <li><p>Landmarks Search API for |
95 <li><p><xref format="html" href="specs/guides/Landmarks_Search_API_Specification/Landmarks_Search_API_Specification.html" scope="external">Landmarks |
94 allowing mobile devices users to search the database</p></li> |
96 Search API</xref> for allowing mobile devices users to search the database</p> |
95 <li><p>Landmarks UI Add/Edit API for |
97 </li> |
96 allowing mobile device users to add and edit landmarks</p></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 |
97 <li><p>Landmarks UI Selector API for |
99 UI Add/Edit API</xref> for allowing mobile device users to add and edit |
98 displaying and selecting landmarks</p></li> |
100 landmarks</p></li> |
99 <li><p>Location Acquisition API for |
101 <li><p><xref format="html" href="specs/guides/Landmarks_UI_Selector_API_Specification/Landmarks_UI_Selector_API_Specification.html" scope="external">Landmarks |
100 finding the location of a mobile device</p></li> |
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> |
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 |
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 |
102 sending location information to other devices</p></li> |
106 sending location information to other devices</p></li> |
103 </ul> |
107 </ul> |
104 </section> |
108 </section> |
105 </conbody></concept> |
109 </conbody></concept> |