Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Fast and easy OpenStreetMap XML/PBF parser.

Project Description

imposm.parser is a Python library that parses OpenStreetMap data in XML and PBF format.

It has a simple API and it is fast and easy to use. It also works across multiple CPU/cores for extra speed.

It is developed and supported by Omniscale and released under the Apache Software License 2.0.


Here is an example that parses an OSM file and counts all ways that are tagged as a highway.

from imposm.parser import OSMParser

# simple class that handles the parsed OSM data.
class HighwayCounter(object):
    highways = 0

    def ways(self, ways):
        # callback method for ways
        for osmid, tags, refs in ways:
            if 'highway' in tags:
              self.highways += 1

# instantiate counter and parser and start parsing
counter = HighwayCounter()
p = OSMParser(concurrency=4, ways_callback=counter.ways)

# done
print counter.highways

Source and issue tracker

Source code and issue tracker are available at


1.0.7 2015-01-10

  • updated protobuf parser

1.0.6 2014-10-31

  • fixed bug in protobuf parser that could cause segfaults

1.0.5 2013-09-13

  • support PBF without granularity value
  • improved support for non-pretty-printed XML

1.0.4 2012-12-10

  • improved support for non-pretty-printed XML
  • fixed dependency check for multiprocessing

1.0.3 2011-07-21

  • support for uncompressed PBF
  • bug fix for PBF without dense nodes

1.0.2 2011-03-10

  • improved regexp based XML coord parser
  • prevent mmap overflow in XMLChunker without coord_callback
  • successfully parsed whole planet.osm

1.0.0 2011-02-22

  • first release
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
imposm.parser-1.0.7.tar.gz (37.4 kB) Copy SHA256 Checksum SHA256 Source Jan 10, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting