From OpenStreetMap Wiki
(Redirected from Townguide)
Jump to: navigation, search
Available languages — TownGuide
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް
Example output. view PDF version

The TownGuide map generator ( is a python program that will render a map to a PDF file and include a street index and an index of user selectable points of interest.

It can run as either a web service or as a stand-alone program if the source code is installed on your computer (from

Note: The demonstration web service that used to be at [1] is not working at the moment - it used the xapi service to obtain OSM data, which was too unreliable, and it has not been updated to use the new jxapi service.

The current version of the program is really a proof of concept demonstration. There are many improvements that could/should be made. These include:

  • Increased output resolution (the output is a bit 'fuzzy' because of low output resolution). (Included in 'townguide2' branch thanks to Waldemar's Google Summer of Code project).
  • Different symbols for different categories of Points of Interest.
  • Deal with overlapping point of interest symbols.
  • Include a mapnik stylesheet editor to provide more customisation of base map.


This programme was developed in parallel with maposmatic, so some of the features are similar. For a simple overview map, maposmatic produces much better output than townguide, so it would be best to use that. What townguide does (or aims to do!) is:

  • Highlight points of interest with numbered markers and provide a key at the bottom.
  • Provide different output formats (poster, booklet)
  • Provide more customisation - add contours to the basic OSM map, add overlays of GPX traces to highlight routes etc.

There are currently two versions of townguide - the original version (in the trunk repository at [2]) and 'townguide2' ([3]). Townguide2 is based on Waldemar's Google Summer of Code project and has re-structured the code to provide the flexibility to add the customisations identified above. But there is more work to get this to a functioning state.

If anyone would like to work on this, they are very welcome to!


An example of a poster output is shown on this page.

A sample booklet can be found at file:Townguide_book.pdf. The book formatting needs more work, but is a proof of concept at the moment.

For details please contact

See also

  • OSM on Paper other ideas around getting OpenStreetMap into printable formats