View source for Om 2008 Locations
From Openmoko
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Templates used on this page:
Return to Om 2008 Locations.
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Templates used on this page:
Return to Om 2008 Locations.
Languages: |
English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • Norsk (bokmål) • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • 中文(中国大陆) • 中文(台灣) • Euskara • Català |
Locations (codenamed Splinter) is a location sharing application based on GPS and SMS. It uses OpenStreetMap as its map source and allows users to manage and share saved locations.
In addition to downloading map images from the OSM server, Locations also supports local maps, which can be downloaded through the Installer. You can also create your own maps if your city is not available. For more information, refer to the #Create Your Own Maps section below.
Use the MAP view to manage Tags with options to save, edit or send. MAP view also allows users to browse maps with zoom in and zoom out for accurate locating. If you get lost while browsing, simply tap the REFRESH button to return to your current position. It's that easy.
LIST view is a a centralized place to view all of your Tags. The LIST view is a combination of your own saved Tags and Tags received by friends. Selecting a Tag takes you to the exact position of the Tag in the MAP view.
Once you are connected to GPS, saving and sending tags to friends is fun and simple.
A map (.eet) is a collection of tiles. You can install maps through Installer or create your own maps. When looking for tiles to use, Locations will first try downloaded (cached) tiles. If it fails, it will look for them in the available maps. If it still fails, it will ask diversity-daemon to download, and cache them. The following subsections provide instructions and tricks you can apply.
Maps can be installed from Installer.
NOTE: Map packing eats lots of memory and fails easily on NEO. |
Locations comes with a tool called om-locations-map-pack. It can be used to pack tile images downloaded from the OSM server into a map package:
om-locations-map-pack /tmp/diversity-maps my_map.eet
Place my_map.eet in either of the directories
/usr/share/om-locations/maps /media/card/om-maps
and Locations will find it automatically.
To share maps for other Neo users to install, see directions on how to * Add a package to Openmoko Repository
By default, tiles downloaded from the OSM server are stored in /tmp/diversity-maps. They disappear after rebooting. This default path can be changed to, for example, use SD card by adding/editing one line
tile_path = /media/card
to ~/.om-locations/config/om-locations.cfg.
config file may reside in ~/diversity-nav/config/diversity-nav.cfg
You can download tiles of a region by specifying -d option in om-locations-map-pack. The usage is
om-locations-map-pack -d version,source,min_level,max_level,lon,lat,width,height <tile-path>
version can be any integer and source should be "osm". For example, to download tiles of Taipei and store them on the SD card, one can
om-locations-map-pack -d `date "+%Y%m%d"`,osm,5,16,121.5,25.0,0.1,0.1 /media/card
In this example, a region of longitude between 121.5 to 121.6 and of latitude bwtween 25.0 to 25.1 is specified. Tiles in this region and of levels from 5 to 16 are downloaded to /media/card. By instructing Locations to use /media/card as its tile path, one could pre-download tiles of any region and have Locations use them.
For now, nmea logging is off by default. To get nmea log for being used, we can send dbus message after om-locations launched as below:
dbus-send --session --dest=org.openmoko.Diversity --type=method_call --print-reply /org/openmoko/Diversity/objects/0/equipments/nmea org.openmoko.Diversity.Equipment.SetConfig string:log variant:string:/home/root/nmealog
Then the log will be saved to /home/root/nmealog in this example.
After om-locations terminated, logging will stop.
The size of log file will increase soon. For now be warned, if the dbus message was sent again, then the log will be overrridden. So backup or do some hacking first before doing that.
Locations is written in C and EFL. It talks to diversity-daemon through D-Bus to, for example, send tags and download tiles.
To compile diversity-daemon,
$ svn checkout svn://svn.projects.openmoko.org/svnroot/diversity/trunk/diversity-daemon $ cd diversity-daemon $ ./configure --enable-session-bus $ make $ sudo make install
Please ensure that at least Control and OpenStreetMap backends are enabled. If not, check that you have libdbus-glib-1-dev and libcurl4-gnutls-dev (on debian) or similar packages installed.
To compile Locations,
$ git clone git://git.openmoko.org/git/om-locations.git $ cd om-locations $ ./autogen.sh $ ./configure $ make $ sudo make install
Locations depends directly on recent versions of eet, evas, ecore, edje, and etk from EFL. Please consult its website for instructions to build them.
Locations uses Trac for bug tracking. When report bugs, please choose category Locations so that they go to the developers directly. There is no mailing list specific for Locations. Please use http://lists.openmoko.org/mailman/listinfo/ for discussion.
Locations will be I18N-aware (support multi-languages) in the next release. To have your language(s) in the supported list, one can take this POT file and upload your translation to Trac by creating a new ticket.
[1] git repository of Locations - http://git.openmoko.org/?p=om-locations.git;a=summary
[2] Diversity project - http://diversity.projects.openmoko.org/
[3] Assassin project - http://code.google.com/p/om-assassin/
[4] OpenStreetMap - http://www.openstreetmap.org/