1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
========
pyosmium
========
This library provides Python bindings for the `Libosmium`_ C++
library, a library for working with OpenStreetMap data in a fast and flexible
manner.
.. _Libosmium: https://github.com/osmcode/libosmium
Installation
============
pyosmium can be installed with pip:
pip install osmium
The Pypi source package already comes bundled with a matching version of
libosmium, protozero and pybind11. Pyosmium additionally depends on
expat, libz, libbz2 and Boost variant and iterator. You need to install
development packages for these libraries. On Debian/Ubuntu do::
sudo apt-get install build-essential cmake libboost-dev \
libexpat1-dev zlib1g-dev libbz2-dev
Python >= 3.8 is supported. Pypy is known not to work.
Documentation
=============
The documentation for the latest release is available at
`osmcode.org`_.
If you find bugs or have feature requests, please report those in the
`Github issue tracker`_. For general questions about using pyosmium you
can contanct the `OSM forum`_.
.. _osmcode.org: http://docs.osmcode.org/pyosmium/latest
.. _Github issue tracker: https://github.com/osmcode/pyosmium/issues/
.. _OSM forum: https://community.openstreetmap.org/
Examples
========
The package contains an `example` directory with small examples on how to use
the library. They are mostly ports of the examples in Libosmium and
osmium-contrib.
Also check out the `Cookbook section`_ in the documentation.
.. _Cookbook section: https://docs.osmcode.org/pyosmium/latest/cookbooks/
Fineprint
=========
Pyosmium is available under the BSD 2-Clause License. See LICENSE.TXT.
The source code can be found on `GitHub`_.
.. _GitHub: https://github.com/osmcode/pyosmium
|
