pydriosm 2.2.0

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

PyDriosm

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.

Installation

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.

Documentation

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

License

• PyDriosm is licensed under GNU General Public License v3.0 or later (GPLv3+).
• The free OpenStreetMap data, which is used for the development of PyDriosm, is licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation (OSMF).

Acknowledgement

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

@software{qian_fu_pydriosm_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       = {https://doi.org/10.5281/zenodo.4281194}
}

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

Contributors

Qian Fu 🌱 💻 🧪 📖