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