Skip to main content

An open-source tool for downloading, reading and PostgreSQL-based I/O of OpenStreetMap data.

Project description


PyPI - Python version ReadTheDocs - Documentation status PyPI - License Codacy grade (Code quality) Zenodo - DOI

PyDriosm is an open-source tool that provides an effortless way to download and access OpenStreetMap (OSM) data in popular file formats, such as shapefile and protobuf binary format (PBF), which are freely available from Geofabrik and BBBike. Additionally, the package offers a comprehensive solution for convenient I/O operations and efficient storage capabilities for parsed OSM data within PostgreSQL databases. This means that users can easily read from and write to PostgreSQL databases, enabling efficient data manipulation, querying, and other essential tasks. Whether you are a researcher, practitioner, or simply interested in working with OSM data, PyDriosm is a valuable tool to streamline your workflow and enhance your experience.


To install the latest release of PyDriosm from PyPI via pip:

pip install --upgrade pydriosm

Please also refer to Installation for more information.

Quick start

For a comprehensive guide with practical examples, please check out the quick-start tutorial. This tutorial showcases how to use the package for various tasks, such as downloading, parsing, and performing storage I/O operations on OSM data using a PostgreSQL database.


The full PyDriosm documentation [HTML] [PDF], which includes more detailed examples, is hosted on ReadTheDocs.



The development of PyDriosm, including the example code that demonstrates how to use the package, heavily relies on freely available OpenStreetMap data. The author would like to express sincere gratitude to all the OpenStreetMap contributors for their invaluable contributions in making this data accessible to the community.

Cite as

Fu, Q. (2020). PyDriosm: an open-source tool for downloading, reading and PostgreSQL-based I/O of OpenStreetMap data. Zenodo. doi:10.5281/zenodo.4281194

  author    = {Qian Fu},
  title     = {{PyDriosm: an open-source tool for downloading, reading
                and PostgreSQL-based I/O of OpenStreetMap data}},
  year      = 2020,
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.4718623},
  url       = {}

(Please also refer to the export options from Zenodo to reference the specific version of PyDriosm as appropriate.)


Qian Fu
Qian Fu

🌱 💻 🧪 📖

Project details

Download files

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

Source Distribution

pydriosm-2.2.0.tar.gz (1.6 MB view hashes)

Uploaded Source

Built Distribution

pydriosm-2.2.0-py3-none-any.whl (1.6 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page