百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
P

pyosmium

> 编程语言
开源

libosmium 的 Python 绑定

391 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

libosmium 的 Python 绑定

pyosmium

Provides Python bindings for the Libosmium C++ library, a library for working with OpenStreetMap data in a fast and flexible manner.

Installation

Pyosmium works with Python >= 3.8. Pypy is known to not work. Support for free-threading Python is currently in an experimental state.

Compiling and using pyosmium on 32bit architectures still works but is not officially supported anymore. There are known issues around working with large OSM IDs on 32bit systems.

Using Pip

The recommended way to install pyosmium is via pip:

bash
pip install osmium

We provide binary wheels for Linux, MacOS and Windows 64bit architectures for all actively maintained Python versions.

For other versions, a source wheel is provided. Make sure to install all external dependencies first. On Debian/Ubuntu-like systems, the following command installs all required packages:

bash
sudo apt-get install build-essential cmake libexpat1-dev zlib1g-dev libbz2-dev

Installing from source

Prerequisites

pyosmium has the following dependencies:

  • libosmium >= 2.16.0 (versions 2.21.0 to 2.23.0 have a known issue when processing extract diffs)
  • protozero
  • cmake
  • Pybind11 >= 2.7
  • expat
  • libz
  • libbz2
  • Python Requests
  • scikit-build-core
  • a C++17-compatible compiler (Clang 13+, GCC 10+ are supported)

Compiling from Source

Make sure to install the development packages for expat, libz and libbz2.

The appropriate versions for Libosmium and Protozero will be downloaded into the contrib directory when building the source package:

python3 -m build -s

Alternatively, provide custom locations for these libraries by setting Libosmium_ROOT and Protozero_ROOT.

To compile and install the bindings, run

bash
pip install .

Compiling for Development

To compile during development, you can use the experimental Editable install mode of scikit-build-core:

Create a virtualenv with scikit-build-core and pybind11 preinstalled:

virtualenv /tmp/dev-venv
/tmp/dev-venv/bin/pip install scikit-build-core pybind11

Now compile pyosmium with:

/tmp/dev-venv/bin/pip --no-build-isolation --config-settings=editable.rebuild=true -Cbuild-dir=/tmp/build -ve.

Examples

The example directory contains small examples on how to use the library. They are mostly ports of the examples in Libosmium and osmium-contrib.

Testing

There is a small test suite in the test directory. This provides unit test for the python bindings, it is not meant to be a test suite for Libosmium.

Testing requires pytest and pytest-httpserver and optionally pytest-run-parallel and shapely. Install those into your dev environment:

/tmp/dev-venv/bin/pip install --no-build-isolation --config-settings=editable.rebuild=true -Cbuild-dir=build -ve.[tests]

The test suite can be run with:

/tmp/dev-venv/bin/pytest test

To test parallel execution on free-threaded Python, run:

/tmp/dev-venv/bin/pytest test --parallel-threads 10 --iterations 100

Documentation

To build the documentation you need mkdocs with the mkdocstrings and jupyter extensions and the material theme.

All necessary packages can be installed via pip:

bash
pip install osmium[docs]

To build the documentation run:

mkdocs build

or to few it locally, you can use:

mkdocs serve

Pregenerated man pages for the tools are available in docs/man. For rebuilding the man pages run:

bash
cd docs
make man

Bugs and Questions

If you find bugs or have feature requests, please report those in the github issue tracker.

For general questions about using pyosmium you can use the OSM development mailing list or ask on OSM help.

License

Pyosmium is available under the BSD 2-Clause License. See LICENSE.TXT.

Authors

Sarah Hoffmann ([email protected]) and otheres. See commit logs for a full list.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Pythonopenstreetmappython

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言