osm-gps-map by nzjrs

Download 1.2.1 archive (Release notes for 1.2.1)

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+ applications.

Currently supports a number of different mapping sources:

• OpenStreetMap (default)
• OpenTopoMap
• OpenCycleMap
• Maps-For-Free
• Google Maps / Satellite and Bing Maps (Virtual Earth)

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 arbitrary 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 navigation
• Includes a set of 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 distribution. On Debian, Ubuntu or similar, you can install the GTK+ library and its Python bindings like this:

sudo apt install libosmgpsmap-1.0-1 gir1.2-osmgpsmap-1.0 python3-gi

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

sudo apt install libosmgpsmap-1.0-dev

Installing From Source

To build from source on Debian or Ubuntu you will need:

sudo apt install build-essential autoconf automake libtool \
  libgtk-3-dev libsoup-3.0-dev libgirepository1.0-dev

Then:

./autogen.sh && make && sudo make install

Download

You may download any of the following archives:

• 1.2.1 archive (Release notes for 1.2.1)
• 1.2.0 archive (Release notes for 1.2.0)
• 1.1.0 archive (Release notes for 1.1.0)
• git snapshot of master (tar) (zip)

You can also clone the project with Git by running:

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

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