- For discontinued OSM2go server, see Osm2go-server.
|License:||GNU General Public License|
|Platforms:||Linux, Maemo, and n800|
Mobile, touchscreen based editor
- 1 What is OSM2Go?
- 2 Current problems with IPv6 record for api.openstreetmap.org
- 3 64 bit bug
- 4 Installation
- 5 Features
- 6 Usage
- 7 Development Status
What is OSM2Go?
OSM2Go is an OSM editor designed to run on small devices. It's written in GTK+/C and currently runs on GTK equipped Unix and Linux desktops and the GTK/Hildon-based Nokia Internet tablets N800/N810/N900 (running the Maemo platform over Linux) for which it's primarily been designed.
Current problems with IPv6 record for api.openstreetmap.org
Currently osm2go 0.8.3 does not work out of the box anymore because libcurl (used for interacting with api.openstreetmap.org) does not retry with IPv4 after IPv6 communication failed. Workaround (as root):
to /etc/hosts. Needs to be updated whenever the api.openstreetmap.org address might change!
- restart dnsmasq such that it rereads /etc/hosts
killall -HUP dnsmasq
- update the server
gconftool-2 --set /apps/osm2go/server --type string http://ap4.openstreetmap.org/api/0.6
- update the server entries in all ~/MyDocs/.osm2go/*/*.proj files accordingly
- probably not necessary and dangerous: patch the hard-coded address in /opt/osm2go/osm2go.bin such that it is ap4 instead of api. Be extremely careful to keep the string same length and not to change anything else.
64 bit bug
There's a fairly serious bug at the moment (see discussion page) (fixed in AMDmi3's version which has now been uploaded to the maemo.org extras-devel repo). This has appeared recently due to needing 64-bit Identifiers.
When a node with an id > 2^31 is modified and the project is closed without uploading the local modification will be lost when the project is loaded again (see this commit fixing it).
Nokia Internet Tablets
You can get a installation package for the Nokia Internet Tablet N800/N810 and N900 from the following links.Click here to install it directly on a N800/N810 (OS 2008 Chinook or Diablo):
For the N900 (with Maemo5) click here :
On Fedora 14 you can compile and run osm2go using this simple steps:
- First install all needed dependencies
su - yum install goocanvas-devel libgnome-devel libsoup-devel libsoup22-devel exit
- Now you can compile osm2go
svn checkout https://vcs.maemo.org/svn/osm2go/trunk cd trunk ./configure make ./src/osm2go
Linux: Debian and Ubuntu
Binary packages for Debian and Ubuntu stable are being built and released via the Maemo garage page for osm2go, and we're seeking a sponsor for uploads into Debian unstable (and from there into the whole Debian-derived ecosystem).
The Debian builds are of OSM2Go's rather loosely defined "desktop" profile, without any Hildon dependencies and with some tweaks to make it more like a desktop app. OSM2Go is still fairly small-screen, and should work nicely on MIDs, netbooks and similar devices.
- Install the needed libraries and headers
sudo zypper install libsoup-devel libgoocanvas3-devel gnome-vfs2-devel libgnome-devel
- Checkout and build as described above.
Other Linux or Unix-like OSes
See below if you prefer to compile directly from source. You can grab one of the .orig.tar.gz files from one of the locations mentioned for Debian too: these files are made from SVN trunk snapshots.
Current featureset includes:
- Managing multiple mapping projects.
- Adding, moving and deletion of ways and nodes and editing their tags.
- JOSM-style presets for speedy tagging.
- Import GPS traces or Live GPS trace for GPS-enabled devices
- WMS server support: NASA satellite imagery
- Limited relation support
- Upload and download changes to the OSM servers!
The typical usage pattern of OSM2Go is probably like this:
- Set up a project with the desired bounds
- download the project data from OSM
- go around mapping
- upload the edited data back to OSM
Setting up a project
Up to four tabs offer you different approaches to define the area you want to download and edit:
- Get extends from internal map. This is the easiest approach and should be used by beginners.
- Export-tab on www.openstreetmap.org to easily get these value. Click on "Manually select a different area" to drag a box on the map.
- Set a center point and define width and height around it
- Get extends from Maemo Mapper. Mind that you need to do at least one move or zoom operation in Maemo Mapper after you started OSM2Go for that data to be readable.
Download OSM data
To download up-to-date OSM data simply tap the "Download..."-button on the project details page.
Go around mapping
For editing a node or way you simply select it by tapping. Tap on the blue info button. You can use the Nokia internet tablet's hardware button in the center of the cursor keys as a hotkey as well. The properties dialog for the selected entity is shown.
Adding a new node/way
- Click on the add node respectively the add way button to activate the add mode.
- Click inside the map to add node(s)
- If you are adding a way click on the green check after you have added the last node to finish the way.
Adding a closed way (polygon)
If you want to add a closed way (=polygon) simply proceed like described in "Add a new way" above. When adding the last closing way segment click on the first node again.
Upload OSM data
After you have finished editing the new data has to be uploaded back to the OSM database. Use the menu "OSM -> Upload..." to do so.
Capable of mapping all important objects and sufficient for small mapping projects. Still under heavy development.
The project page for OSM2Go can be found at https://garage.maemo.org/projects/osm2go/.
Source code access
The source code is available from the Maemo extras repository in Debian package form, but OSM2Go's code is maintained in the Maemo Garage SVN repository.
There is currently a single active mailing list for this project: osm2go-users. Technical discussion and user support can be found in the archives.
- 0.8: Beginner friendliness,Automatic demo project installation, Setup/Upload wizards ,Maemo 5 / Fremantle integration
- 0.7: Maemo Fremantle support, API 0.6 support, Performance optimizations
- 0.6: Relation handling
- 0.5: Adding and deleting ways, splitting and joining ways and nodes, polygon handling
- 0.4: JOSM presets
- 0.3: GPS (live and tracks) visualization, WMS server inclusion, multiple projects
- 0.2: Node editing, moving, tagging
- 0.1: Initial test release, single project
Planned milestones are:
- HW acceleration (clutter-gtk)