Om 2008 Locations
From Openmoko
Jeremy.chang (Talk | contribs) (→Turn on logging) |
(new functions in om-locations-map-pack) |
||
Line 51: | Line 51: | ||
In control part, we have a nav object for controlling the navigation, showing the tileset. | In control part, we have a nav object for controlling the navigation, showing the tileset. | ||
− | == Create | + | == Maps == |
− | '''Locations''' comes with a tool called '''om-locations-map-pack'''. It can be used to pack tile images downloaded from OSM server into a map package: | + | |
+ | === Installation === | ||
+ | Maps can be installed from [http://wiki.openmoko.org/wiki/Om2008.8_Installer Installer]. | ||
+ | |||
+ | {| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; " | ||
+ | ! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " | | ||
+ | [[Image:Install.png|200px|thumb|catogory]] | ||
+ | ! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " | | ||
+ | [[Image:Install_maps2.png|200px|thumb|choose map]] | ||
+ | ! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " | | ||
+ | [[Image:Install_maps3.png|200px|thumb|install map]] | ||
+ | |} | ||
+ | |||
+ | === Create Your Own Maps === | ||
+ | |||
+ | {{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: | ||
<pre> | <pre> | ||
Line 66: | Line 83: | ||
and '''Locations''' will find it automatically. | and '''Locations''' will find it automatically. | ||
− | |||
− | |||
=== Share Maps === | === Share Maps === | ||
To share maps for other Neo users to install, see directions on how to * [[CommunityRepository#How_to_release_packages | Add a package to Openmoko Repository]] | To share maps for other Neo users to install, see directions on how to * [[CommunityRepository#How_to_release_packages | Add a package to Openmoko Repository]] | ||
+ | |||
+ | === Use SD Card for Tile Storage (git only) === | ||
+ | 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 | ||
+ | <pre> | ||
+ | tile_path = /media/card | ||
+ | </pre> | ||
+ | |||
+ | to '''~/.om-locations/config/om-locations.cfg'''. | ||
+ | |||
+ | === Download Tiles of a Region (git only) === | ||
+ | You can download tiles of a region by specifying '''-d''' option in '''om-locations-map-pack'''. The usage is | ||
+ | |||
+ | <pre> | ||
+ | om-locations-map-pack -d version,source,min_level,max_level,lon,lat,width,height <tile-path> | ||
+ | </pre> | ||
+ | |||
+ | For example, to download tiles of Taipei and store them on the SD card, one can | ||
+ | |||
+ | <pre> | ||
+ | om-locations-map-pack -d 0,osm,5,16,121.5,25.0,0.1,0.1 /media/card | ||
+ | </pre> | ||
+ | |||
+ | Those important are the last four parameter, which gives the region to download. | ||
== Turn on logging == | == Turn on logging == | ||
Line 82: | Line 120: | ||
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. | 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. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Reference == | == Reference == |
Revision as of 12:32, 2 September 2008
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à |
Om 2008
- Presentation
- Tips & tricks
- Keyboard guide
- Package manager
- Location sharing
Contents |
Introduction
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.
Usage
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 Offline Maps section below.
Map
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
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.
Save & Send Tags
Once you are connected to GPS, saving and sending tags to friends is fun and simple.
- Save a Tag
- Press the touch me bubble that hovers above your current position.
- After the message box appears, tap directly into the text boxes under Edit Title and Edit Messages to add your Tag title or message.
- After entering your title or message, press SAVE, at which point your newly created Tag will appear in bot MAP and LIST views.
- In the MAP view, tapping on the text of your Tag provides further options to edit or send your your Tag to a friend.
- Send a Tag
- In the MAP view, tap on the text of your Tag, launching the edit * send bubble.
- Pressing on send will launch the Send a Tag message box
- Tap directly within the text boxes to edit your Tag before sending, or press Send and your Tag will be on its way.
Architecture
Locations is a UI application, communicating with the diversity-daemon dbus interface to get all the data it needs. What Locations does and shows is based on and through diversity-daemon, like tag management, sharing, map downloading and GPS status.
Design
Locations uses the EFL library to implement UI. Synced with diversity-daemon, Locations has objects, world and viewport concepts. There is a dbus wrapper layer for the diversity-daemon. In the UI, we have widgets like dialogs, menus, different objects like tags, map tilesets, etc.
In control part, we have a nav object for controlling the navigation, showing the tileset.
Maps
Installation
Maps can be installed from Installer.
Create Your Own Maps
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
Use SD Card for Tile Storage (git only)
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.
Download Tiles of a Region (git only)
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>
For example, to download tiles of Taipei and store them on the SD card, one can
om-locations-map-pack -d 0,osm,5,16,121.5,25.0,0.1,0.1 /media/card
Those important are the last four parameter, which gives the region to download.
Turn on logging
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.
Reference
[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/