Skip to main content

Client for the Offenes Köln API

Project description

Offenes Köln is a platform that allows for flexible access
to the content of the City of Cologne/Germany's city council information system.

Find more information about the platform at

More detailed information on the REST API is available at


pip install okclient

**Quick start**

import okclient
oc = okclient.Client()

# Search for documents containing "Haushalt"
result = oc.documents(query="haushalt")
for doc in result:
print, doc.title

# Retrieve the document with identifier "3323/2008"
# including attachments and thumbnails
result = oc.documents("3323/2008", attachments=True,
print result[0].date, result[0].title
print result[0].attachments[0].url
print result[0].attachments[0].content

# Find streets surrounding a geo position
# (reverse geocoding)
streets = oc.streets(lat=50.959, lon=6.946)
for street in streets:
(name, distance) = street
print "%s is $d meters away" % (name, distance)

# Find position of street "Mittelstraße"
# (also called geocoding)
mittelstr = oc.locations("Mittelstraße")
# return quasi-centroid of that street
print mittelstraße.averages[0]
# print out all nodes of that streets
for node in mittelstraße.nodes:
print node


Feel free to give feedback via the Issue tracking at

**Stay tuned**

Stay informed about changes in this client and the API by following our
commits on Github (see URL above), reading our Blog and/or following
the twitter account.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

okclient-0.2.tar.gz (4.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page