okclient

Client for the Offenes Köln API


License
Unlicense
Install
pip install okclient==0.3

Documentation

ok-python-client

Python Client für die Offenes Köln API

Installation

pip install okclient

Quickstart

import okclient

oc = okclient.Client()

# Suche nach Dokumente mit dem Begriff "haushalt"
result = oc.documents(query="haushalt")
for doc in result:
    print doc.date, doc.title

# Dokument mit der Kennung "3323/2008" abholen,
# mit Attachments und Thumbnails
result = oc.documents("3323/2008", attachments=True,
                      thumbnails=True)
print result[0].date, result[0].title
print result[0].attachments[0].url
print result[0].attachments[0].content

# Straßen im Umkreis einer bestimmten Position finden
streets = oc.streets(lat=50.959, lon=6.946)
for (name, distance) in streets:
    print "%s is %d meters away" % (name, distance)

# Position der "Mittelstraße" abrufen
mittelstr = oc.locations("Mittelstraße")
# Mittelpunkt der Mitteltraße ausgeben
print mittelstr.averages[0]
# Knoten der Mittelstraße ausgeben
for node in mittelstr.nodes:
    print node

Status

Diese drei öffentlichen Methoden der Offenes Köln API werden unterstützt:

  • documents (/api/documents) zum Abruf von Dokumenten
  • streets ( /api/streets) zum Finden von Straßen im Umkreis eine Geo-Position
  • locations (/api/locations) zum Abruf von Ortsinformationen zu Straßen und Plätzen

Der Zugriff auf die anderen API-Methoden (siehe http://offeneskoeln.de/api/) ist noch nicht implementiert.

Feedback

ist immer herzlich willkommen! Bitte benutzt die Seite "Issues" in der Navigation. Oder schickt Pull Requests.

Lizenz

Public Domain

Weitere Info