Geography Reference
In-Depth Information
5.2.1 Get Current Location: getGPSFix()
In order to get the most accurate location, the application scans through all
location providers and chooses the best one. Then it polls that location provider
until it has a location with an acceptable error and records the location. Now any
other part of the Virtual Stickies application can use the provided location to center
the map or add a new note.
5.2.2 Searching for Notes: doSearch()
When the user sends a search request to the server, the current location and a user
defined radius will be sent and used as search parameters on the server. It is
intended that these parameters can be extended to anything like the category or
title of a note.
5.2.3 Adding a New Note: createNote()
When the user adds a new note the application sends the current location, the
message and the radius. This is the bare minimum currently available and will be
extended in the future. The server responds with the new note and a corresponding
unique ID.
5.2.4 Updating a Note: updateNote()
Updating a note requires the user to be the owner of the note in question. Then the
application allows the changing of the message text and the radius of the note. As
above in future there will be more options to change. Lastly the newly updated
note will be sent to the server, which responds with success or failure.
5.2.5 Deleting a Note: deleteNote()
Once the user has chosen a note to delete, the application recovers the unique ID of
that note and sends along a deletion request to the server. The server responds with
success or failure.
5.3 Submission and Retrieval of Objects
The submission and retrieval of objects is done by the user directly on the phone.
