Supported Python versions:

  • Python 2.7
  • Python > 3.2
  • PyPy


As a Python egg

You can install the most recent version using pip

$ 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.

$ python install

Install the development version

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

$ git clone
$ cd python-overpy
$ python install


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 examples page or in the examples directory.

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.lon))