Created page with "{{Languages}} {{Software2 |name=ShareNav |author=Jyrki Kuoppala,S. Hochmuth,Kai Krueger,Harald Mueller,Markus Baeurle & others |wiki=ShareNav |web=http://www.sharenav.net |svn= |..."
New page
{{Languages}}
{{Software2
|name=ShareNav
|author=Jyrki Kuoppala,S. Hochmuth,Kai Krueger,Harald Mueller,Markus Baeurle & others
|wiki=ShareNav
|web=http://www.sharenav.net
|svn=
|platform=Android;J2ME
|code=Java
|framework=Android;J2ME
|languages=EN; DE; FI; CS; PL; RU; FR; IT; ES; SK
|genre=display;navi;logger;router;editor;renderer
|license=GPLv2
|price=€2.99 on Google Play Store
|version=0.8.3
|date=2012-09-12
|screenshot=ShareNavScreenshot1.png
|description=very portable navi for Android&J2ME mobile phones, uses offline vector maps, audio navigation
|map=yes
|tracking=yes
|monitoring=yes
|navigating=yes
|routing=yes
|mapData=vector;raster
|datasource=offline;online
|rotateMap=yes
|3D=yes
|navToPoint=yes
|findLocation=yes
|findNearbyPOI=yes
|navigateRoute=calc
|predefinedRoute=no
|createRouteManually=no
|calculateRoute=yes
|calculateRouteOffline=yes
|profiles=car;bike;foot
|turnRestrictions=yes
|voice=yes
|keepOnRoad=yes
|withoutGPS=yes
|customInterval=yes
|formats=gpx;nmea
|geotagging=photo;audio
|fastWayPointAdding=yes
|uploadGPX=yes
|sendPosition=sms
|showTrack=yes
|showExistingTrack=yes
|showAltitudeDiagram=yes
|showDOP=yes
|showSatellites=yes
|showNMEAlive=yes
|addPOI=yes
|addWay=no
|editSource=offline
|editPOI=yes
|editTags=yes
|editGeom=not directly, will open web browser editor for area
|editRelations=no
|uploadOSMData=yes
|showSpeed=yes
}}
[[Image:ShareNav map.jpg|thumb|288px|Viewing maps]]
[[Image:ShareNav way tagging.jpg|thumb|288px|Live editing of a tag on a way]]
ShareNav is based on GpsMid code version 0.8.2. New features in ShareNav as compared to GpsMid are support for online functions (ready-to-run in Google Play Store version) and different and hopefully easier UI for Android.
ShareNav is free software licensed under the GPL, version 2.
=Introduction=
== Overview ==
ShareNav provides vector based rendering of OSM data, which gets pre-compiled into an efficient binary representation.
== Features ==
* GPS location using GPS (external via bluetooth, builtin, SiRF, Cell-id based proximity (using [[OpenCellID]]))
* Vector rendering, arbitrary map zoom, auto rotating in movement direction
* Optional showing of raster maps from a tile server (not required for navigation and map viewing)
* Customization of rendering styles through a [http://wiki.openstreetmap.org/wiki/ShareNav/StyleSheet StyleSheet]
* Search for road / POI names, search for closest POI of some category
* Recording GPX tracks, storing waypoints,
* Turn-by-turn voice guided navigation calculated inside the application itself, supporting different modes of transport e.g. cycling and walking
* Adding new POIs to OSM directly from your phone
* Editing tags on existing ways.
* Uploading GPX tracks directly to OSM server
* [[OpenCellID]] logging (an interface to the upload api is found [http://opencellid.org/measure/upload here])
==Supported / Unsupported Phones and other devices==
ShareNav works on a '''large set of smart and feature phones''' as well as some other devices '''supporting Android or mobile java (J2ME)'''. For J2ME, the support is largely like on GpsMid, details omitted for brevity, look at the [[GpsMid]] entry for that.
== Download ShareNav ==
ShareNav can be downloaded from Google Play Store, formerly known as the Android Market.
FIXME add info about maps
==Development==
FIXME
Report bugs at
Feature requests at
Discussions at
Access to GIT repository via
More information about development can be found on the pages [[ShareNav/Development]] and [http://sourceforge.net/apps/mediawiki/gpsmid/index.php?title=Main_Page ShareNav wiki]
==Creating maps for ShareNav==
There's available a java application, Osm2ShareNav, to be run on a laptop or desktop computer which can be used to create the vector-based offline maps (with routing data) for ShareNav. Also maps created for GpsMid will work.
=Map=
As an offline map application, ShareNav needs to store the data on the device. ShareNav uses its own binary data format to be as efficiently as possible in size requirements, as well as optimise for routing. Therefore, the raw data from OpenStreetMap has to be converted and bundled into a map data bundle. This is done by using the Osm2ShareNav converter that runs on your PC (not your phone)
As many (older) java phones are / were not very good at dealing with external files, the default method is to bundle the data into the application .jar file. However, more recent versions also support splitting out the application and the map data.
==Download pre-bundled map==
For easy use (don't need to do the bundling step your self), there are some pre-bundled maps available for download that can directly be uploaded to your phone.
*[http://gpsmid.sourceforge.net/prebuild/ Download pre-bundled maps] for a select regions. If your city / region isn't amongst them, you can ask for it to be added on the [http://sourceforge.net/forum/?group_id=192084 forums].
*[http://www.geothings.net/gpsmidmaker.html#more Geothings] let you select area boundingbox and generate a midlet
*[http://wiki.freemap.sk/ShareNav freemap Slovakia] let you download prebuilt midlets for various Slovak cities
==Create custom map==
To create ShareNav build with map data for your own regions, you first have to download the raw data from OpenStreetMap (*.osm). Then in the conversion using Osm2ShareNav, a subset of the downloaded data (defined by up to 9 rectangular regions) will be included in the generated bundle.
===Raw OSM data===
There are a number of options to obtain the raw data of OSM.
*[[Planet.osm]]
*[http://wiki.openstreetmap.org/wiki/Planet.osm#Extracts Country sized extracts ]
*[http://www.openstreetmap.org/ www.openstreetmap.org] |zoom to your area | Export
*[[TRAPI]]
'''Using something other than planet extracts is strongly discouraged other than for very small regions (a few streets)'''.
===Configuring your map bundle===
Osm2ShareNav provides a graphical interface to selecting most of the configuration options for the bundling process. For more advanced use, there is also the option to configure the conversion process through a text file (.properties file).
One of the parameters to set is the "Phone capabilities". Although java was designed to write once run everywhere, not all implementations of Java on phones is fully compatible with each other. Therefore ShareNav provides a couple of different options to increase you chance of it working.
In nearly all cases though, '''Generic-full-editing or Generic-full''' should be used, as they provide the most comprehensive set of features.
== manage Audio ==
It is possible to use ShareNav for [[Audio_mapping | Audio Mapping]] as it allows the user to record sound clips, and creates a GPX waypoint associated with each clip. The audio clips and GPX file can then be processed for use in [[JOSM]] for mapping.
The process for doing is explain below: :
.
===record voice===
* Start ShareNav and associate it with your bluetooth GPS receiver (in the settings screen). Also set the GPX output to go to C:\Other in the settings screen, then go to the map screen.
* Record an audio clip by double clicking the '#' key. (Note that currently you have to say 'yes' to a few questions about allowing the program to access user data - I'll try to make this go away in a future version). The first time you do this you may also have to select the destination directory for the audio clips. I use C:\Other.
* Stop the recording by double clicking the '#' key again.
This process leaves you with a lot of audio clips in your phones memory, and the GPX waypoints hidden in ShareNav's own storage area. To get these in to JOSM on your PC, do the following:
* In ShareNav, go to 'Manage Waypoints' from the map screen. Select 'Send All'. I have this configured to write to C:\Other - the same place as the audio clips go. This puts a file 'waypoints.gpx' in C:\Other on the mobile phone.
* Exit ShareNav and use your phone's file manager to send the files to your PC, using either bluetooth or a USB connection. Store the GPX file and the audio clips (*.amr) in the same directory on your PC.
===use in josm ===
* To use these in JOSM, the audio files need converting into .wav files, and the GPX file needs
tags adding to point to the audio files. A little python script [http://svn.openstreetmap.org/applications/utils/amr2wav amr2wav] can be used to do this. Just running "amr2wav" in the directory containing the files should be all you need to do [Note though that you need [http://ffmpeg.org ffmpeg] to do the conversions. It might be necessary to re-compile ffmpeg from source to add amr support]. This creates a .wav file for each .amr file referenced in the GPX data, and a new GPX file "waypoints_wav.gpx".
* Start [[JOSM]] and open "waypoints_wav.gpx". You should see a marker for each audio file. Clicking on the marker should play the clip.
* Job done!
Notes: Although having to say 'yes' to allow the application to write user data sounds like a real pain, it is surprising how easy it is to get used to how many times you have to press the OK key. It also appears that the later Sony-Ericsson phones that use "Java Platform 8" allow you to switch off the prompts for file access - I have ordered one to see if this works.
== ShareNav's editing capabilities ==
Currently ShareNav is not a full editor, but does at least allow some data maintenance in the field. Currently, it allows you to select a way in the map
and edit or add tags of that way and directly upload the changes to the main openstreetmap database. This can be useful for example to quickly add a missing name, a speed restriction, set it to oneway or add some of the other meta data that is often still missing from ways.
The way it works is to store the osm way id in the offline map data. If you then select that way for editing, it will connect via the internet to the API and download the current way data and display its tags. Once you have added or corrected any tags, you can upload the way and commit it to the database. Given that it retrieves the tags freshly from the database, not having updated the map of ShareNav shouldn't be problematic, although having fresh maps is preferable
As this feature requires internet access on the phone, and one of ShareNavs main features is to be an offline application, these features aren't enabled by default. In order to enable them, you need to choose the following settings in your .properties file with which you create your midlet. You will need to set the app parameter to ''app=Generic-editing'' (or with Version 0.5.00 ''app=ShareNav-Generic-editing'') to enable online features in ShareNav and you need ''EnableEditing=true'' (or ''enableEditing=true'' depending on the version of ShareNav) to include the necessary information for editing in the map build. With that you should be ready to start editing the map on the go.
So far the editing support is limited, but hopefully more features, especially POI editing will follow soon.
== Supported files==
File extensions that could be use in this article and are useful with ShareNav (creating map, recording data).
*GPX :file for storage lat/long/name location
*amr : audio file compatible with many mobile devices and software ( [[http://svn.openstreetmap.org/applications/utils/amr2wav amr2wav]]/nokia audio/ real player)
*png : read raster image for poi
*.xml/.dtd read have default name style-file that define default display style but can be custom ( see [[ShareNav/StyleSheet]] )
*osm : specific vector format file of osm map for storage data directly on filesystem instead database.
*properties : file use to specify boundingbox, stylesheet and tag information that is used by ShareNav.
[[Category:Outputs]]
[[Category:Free software]]
[[Category:Java midlet]]
[[Category:Routing]]
[[Category:Mobile]]
[[Category:Editors]]
[[Category:Windows_Mobile]]
[[Category:Users_of_ShareNav| Users of ShareNav]]
[[Category:Android]]