Location information may be stored as database entries called landmarks that contain at least a name and a location.
Typical use cases include:
Sending location information that is stored according to the World Geodetic System (WGS 84) to another device.
Finding sites within a set distance of a stored point.
Note: The SDK does not include a map API, and therefore you must use a third party API to display the location information you receive on a map.
To store location information on your mobile device:
Make use of the methods of the Landmarks API when constructing your application.
The CPosLandmarkDatabase class is used for accessing the database with the landmarks information and the CPosLandmark class contains the location information.
For detailed information on how to do this, refer to the following topics in Symbian C++ API specifications:
Using landmarks database for a discussion of how to start accessing the database with the location information, including a structure diagram.
Managing landmarks for code samples of opening, editing, and adding location information to a database
Listening to database events for possible events type passed to your application and code samples for implementing a listener
The TPosLmEvent class is used in listening for events.
Make
sure eposlandmarks.lib is accessible to your linker
when compiling your application by including it in your .mmp file
or by editing the project properties in your IDE, depending on your
build environment.
Make
sure you have the correct capabilities information set for your application,
depending on your application you may need LocalServices, NetworkServices, ReadDeviceData, ReadUserData, WriteDeviceData, and WriteUserData.
For more information see,
API description for a description of the API and its class structure
Using the Landmarks API for a general overview on how to create applications using the API
For a reference example on searching and manipulating
the information in the location database, see LocationLandmarksRefAppForS60 in the SDK (<SDK installation directory>\S60CppExamples\)
For a reference example on how to use common UI components
to work with landmark data, see LocationLandmarksUIRefApp in the SDK (<SDK installation directory>\S60CppExamples\AutoAdaptedToTouchEx\)
The Symbian platform also offers the following related APIs:
Landmarks API for accessing the database
Landmarks Database Management API for creating and deleting databases
Landmarks Search API for allowing mobile devices users to search the database
Landmarks UI Add/Edit API for allowing mobile device users to add and edit landmarks
Landmarks UI Selector API for displaying and selecting landmarks
Location Acquisition API for finding the location of a mobile device
For more information about these APIs, see Symbian C++ API specifications.