File: introduction.rst

package info (click to toggle)
python-overpy 0.7-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 556 kB
  • sloc: python: 2,235; xml: 1,055; makefile: 150
file content (73 lines) | stat: -rw-r--r-- 1,536 bytes parent folder | download | duplicates (2)
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
62
63
64
65
66
67
68
69
70
71
72
73
Introduction
============

Requirements
------------

Supported Python versions:

* Python 3.6+
* PyPy3

Installation
------------

As a Python egg
~~~~~~~~~~~~~~~

You can install the most recent version using ``pip``

.. code-block:: console

    $ pip install overpy


From a tarball release
~~~~~~~~~~~~~~~~~~~~~~

Download the most recent tarball from github, unpack it and run the following command on the command-line.

.. code-block:: console

    $ python setup.py install


Install the development version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Install git and run the following commands on the command-line.

.. code-block:: console

    $ git clone https://github.com/DinoTools/python-overpy.git
    $ cd python-overpy
    $ python setup.py install

Usage
-----

It is recommended to have a look at the documentation of the `Overpass API`_ before using OverPy.
For more examples have a look at the :doc:`examples page <example>` or in the examples directory.

.. code-block:: python

    import overpy

    api = overpy.Overpass()

    # fetch all ways and nodes
    result = api.query("""
        way(50.746,7.154,50.748,7.157) ["highway"];
        (._;>;);
        out body;
        """)

    for way in result.ways:
        print("Name: %s" % way.tags.get("name", "n/a"))
        print("  Highway: %s" % way.tags.get("highway", "n/a"))
        print("  Nodes:")
        for node in way.nodes:
            print("    Lat: %f, Lon: %f" % (node.lat, node.lon))


.. _Overpass API: https://wiki.openstreetmap.org/wiki/Overpass_API