Skip to content

mikeqfu/pydriosm

Repository files navigation

PyDriosm

A Python package for downloading, reading and PostgreSQL-based I/O of OpenStreetMap data.

PyPI Release Version Python Version License ReadTheDocs Documentation GitHub Actions Workflow Status Codacy - Code Quality 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 can be useful and helpful to streamline your workflow and enhance your experience.

Installation

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

$ pip install --upgrade pydriosm

For more information, see the Installation.

Quick start

For a concise guide with practical examples, please check out the Quick Start tutorial, which demonstrates how to use PyDriosm to download, parse and perform storage I/O operations on OSM data using a PostgreSQL database.

Documentation

The complete PyHelpers Documentation is available in [HTML] [PDF] formats.

It is hosted on ReadTheDocs and provides detailed examples, tutorials and comprehensive references to help users get the most out of PyDriosm.

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.4281194},
  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.)

License

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.

Packages

 
 
 

Contributors

Languages