Osm2go

From OpenStreetMap Wiki
Jump to: navigation, search
For discontinued OSM2go server, see Osm2go-server.
OSM2Go
Screenshot of OSM2Go
Author: Till Harbaum
Website: https://garage.maemo.org/frs/?group_id=830
Version: 0.8.3 (2010-02-21)
License: GPL
Platform: linux ; maemo ; n800 ; n900

Mobile, touchscreen based editor


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 desktops and the GTK/Hildon based Nokia Internet Tablets N800/N810/N900 for which it's primarily been designed.

OSM2Go is currently maintained by AMDmi3, download latest source code here.

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):

  • add
193.63.75.103 ap4.openstreetmap.org

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.

Installation

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):
http://maemo.org/downloads/product/raw/OS2008/osm2go/?get_installfileMaemo Install.png


For the N900 (with Maemo5) click here :
http://maemo.org/downloads/product/raw/Maemo5/osm2go/?get_installfileMaemo Install.png

Linux: Fedora

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 binary packages are outdated, and will not work with the current OSM Api.

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.

Linux: openSUSE

  • 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.

Features

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!

Screenshots

Usage

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

Osm2go new project.png
On startup the tool show the project selection. Use the "New..."-button in the lower left corner to set up a new project. First add a name and oIf this is not displayed use Menu --> Project --> Open... and click the Add button. In the next screen enter a project description. Then continue by clicking the "Edit..."-button on the right.

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 OSM.org
    Use min/max latitude and longitude to define a rectangular box. If you have a desktop computer nearby you can use the 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

Editing a node/way's tags

For editing a node or way you simply select it by tapping. Tap on the blue Osm2go info button.png 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

Osm2go add node.png
Osm2go add way.png
  • 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.

Development Status

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.

Mailing lists

There is currently a single active mailing list for this project: osm2go-users. Technical discussion and user support can be found in the archives.

History

  • 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


What's next?

Planned milestones are:

Version 0.9:

  • Undo/Redo
  • HW acceleration (clutter-gtk)

Version 1.0:

  • ...