osm-gps-map by nzjrs

A Gtk+ widget (and Python bindings) that when given GPS co-ordinates, draws a GPS track, and points of interest on a moving map display. Downloads map data from a number of websites, including openstreetmap.org. The library has excellent performance and is currently used in a number of Gtk+ and Maemo applications.

Currently supports a number of different mapping sources

• openstreetmap (default)
• maps-for-free
• satellite maps from a number of proprietary providers

It also has the following features

• Intelligent, flexible and customizable caching of maps, including the ability to request a specific area of the map to be cached ahead of time
• Recording of points of interest on the map (and the ability to add arbitary pixmaps at those points
• Automatically draws a GPS track (a line showing the history of past added points)
• Automatic centering on new GPS points
• Support for multiple other tracks of co-ordinate points
• Adjustable Zoom
• Built in support for keyboard navgation
• Includes a comprehensive examples
• Simple, flat API
• Support for showing additional display layers rendered on top of the map
• Optional on screen display (OSD)
• Proper map copyright attribution and user-agent usage to comply with various map requirements

Documentation

• API Documentation
• Code examples
• mapviewer.c
• mapviewer.py
• mapviewer.js (JavaScript example using GObject Introspection)
• polygon.c (small polygon-on-map drawing example)
• editable_track.c (small example of an editable track feature)
• Please e-mail the mailing list for all questions.
• Report issues using issue tracker

Install Instructions

osm-gps-map should be packaged by your distibution. On Debian, Ubuntu or similar, you can install the GTK+ library and its Python bindings like this:

sudo apt-get install libosmgpsmap-1.0-1 gir1.2-osmgpsmap-1.0

And if you want to build some application that depends on osm-gps-map, you can install development binding like this:

sudo apt-get install libosmgpsmap-1.0-dev

Installing From Source

To build from source on Linux you will need to install the following dependencies:

• libsoup-2.4
• gtk+-3.0
• cairo
• gobject-introspection

Once the dependencies have been installed you can build osm-gps-map. On Linux perform the following:

./autogen.sh; make; make install #C library

Download

You may download any of the following archives

• 1.2.0
• 1.1.0
• unstable snapshot (tar) (zip)

You can also clone the project with Git by running:

$ git clone git://github.com/nzjrs/osm-gps-map

License

• GPLv2+

Authors

• John Stowers
• Till Harbaum
• Alberto Mardegan
• Mark Cottrell
• Originally based on tangoGPS by Marcus Bauer

Contact

• osm-gps-map mailing list
• osm-gps-map issue tracker