The Map View¶
The map view is the central view of the application. It can be used to view the current gps position, several maps and datasets and can be used to navigate.
The map engine comes from the mapsforge project.
The supported datasets section lists and describes all supported map types. Just to cite a few, one can view:
- OpenStreetMap maps both when online (downloading new tiles) and offline (visualizing those that were cached during online mode)
- mbtiles databases
- local and remote TMS tiles
- mapsforge vector files
Map view tools¶
The map view has a set of tools that can be exploited to interact with the map.
When first launched, the tools are already visible on the map. To have a cleaner mapview, the user can long-tap on the upper right menu button to toggle the visibility of the tools.
Available tools are:
- Left screen side
- add note (the same that is accessed from the dashboard)
- list all notes
- add bookmark
- list all bookmarks
- activate the measure tool
- Right screen side
- the context menu button
- the zoom in and out buttons
- Lower center
- battery status
- center screen on GPS position and GPS status button
- editing tools
The add notes button opens the same notes view as the button on the dashboard. There is only once difference. Since notes can be added both in the gps position and in the middle of the map, to open the add note view from the dashboard, the GPS is required to have a fix.
Instead from the map view the user can open the add note view even without GPS signal, in which case he will be allowed to insert notes only in the map center position.
For further information about taking notes, visit the notes section.
The Notes List¶
The notes list shows all the available notes, both text and image notes.
In the upper part there is a textbox that helps to filter out a particular note based on its name.
At the right side of the list 2 icon are available. The left one positions the map on the selected note’s position. The rigth one opens a menu:
From the note menu the user is able to:
- share the note through social networks
- delete the note
- use the current note as a filter
- access the submenu related to all notes
From the all-notes submenu the user can:
- select all notes
- invert the current selection
- delete the selected notes
Bookmarks are in a layer on their own, that contains saved settings of the current map view. When a bookmark is added, the user is prompted to insert a name for the bookmark or leave the generated name based on the current time and date.
When a bookmark is added , a small star is added on the map in the center of the screen.
Also the map bounds and zoom are saved. That way one can return to the scenario that the bookmark represents in any moment.
It is possible to tap on the bookmark to read its label.
The Bookmarks List¶
The bookmarks list shows all the saved bookmarks.
In the upper part there is a textbox that helps to filter out a particular bookmark based on its name.
The user has 4 options, as the icons on each bookmark entry shows:
- go to the bookmark location
- add a proximity alert. In that case a dialog opens and asks for a radius in meters to define the proximity area. Once the gps enters that area, the user will be notified
- rename the bookmark
- delete the bookmark
Activating the measure tool puts the app in measure mode. This mode disables the ability to pan the map while enabling the possibility to draw a line on the map and measure the line drawn.
The approximate (the distance is calculated without considering elevation deltas and with the coordinate picking precision of a finger on a screen) distance is shown in the upper part of the map view.
When active, the measure tool has a red colored icon, when inactive the icon is green instead.
Gps log analysis tool¶
Apart of charting the log it is possible to analyze the various positions of a gps log. The tool to do so is hidden behind the editing tools button.
If no editing layer is enabled, only two tools appear in the editing tools bar. The lower one is the one that can be used to analize the logs:
Once enabled, one can simply touch the screen near a gps log and information about the nearest log point will be shown. Also the color of the text will be the one of the currently queried log: