Markus Möller

Achtung! Das Thema dieses Blog-Artikels ist technisch. Sehr technisch. Wenn du mit Programmierung nichts am Hut hast, dann kannst du diesen Beitrag überspringen. Ausnahmsweise. Ab ins Freibad!

OK, Kollegen, nun sind wir also unter uns. Als Programmierer kennst du ja sicherlich schon unsere API. Mit dieser offenen Programmierschnittstelle ist es möglich, auf die Daten der Erklärmaschine zuzugreifen und selbst Applikationen zu schreiben.

Nun gibt es gleich zwei Neuigkeiten. Erstens experimentieren wir gerade mit der Geokodierung von Twicks und möchten diese Funktion gerne über die API freigeben und zweitens können PHP-Programmierer nun Wrapper-Klassen nutzen, um uns noch einfacher anzuzapfen.

Geokodierung

Seit kurzem werden die Themen bei Twick.it mit Geokoordinaten (Längen- und Breitengrad) versehen. Diese Funktion befindet sich zwar noch in einem frühen Beta-Stadium, aber ihr könnt trotzdem schon drauf zugreifen. Die Rückgaben der Funktions-Aufrufe liefern dazu sowohl im XML- als auch im JSON-Format einen Geo-Block, der Längen- und Breitengrad als Bogenmaß angibt.

Auch eine neue Funktion find_topics_nearby gibt es. Der Sinn dieser Funktion ist schnell erklärt: Ihr übergebt dem Aufruf eure eigene Position und bekommt Themen, die sich in der Nähe befinden. Einzelheiten und ein Beispiel findet ihr wie immer in der API-Dokumentation.

PHP-Wrapper

Wenn ihr mit PHP auf die Twick.it-Schnittstelle zugreifen wollt, könnt ihr euch das Leben jetzt noch einfacher machen. Wir haben einige Wrapper-Klassen geschrieben, die dafür sorgen, dass ihr euch nicht mehr mit dem ganzen REST-Zeugs (http-Request senden und XML parsen) herumschlagen müsst. Stattdessen gibt es eine PHP-Klasse, die die Twick.it-Funktionen als statische Methoden zur Verfügung stellt. Die Rückgabe erfolgt schön strukturiert in Form spezieller Twick.it-Klassen.

Natürlich ist der PHP-Wrapper kostenlos und steht unter der BSD Licence. Kurz gesagt: Ihr dürft damit machen, was ihr wollt. Zu finden ist diese PHP-Zauberkiste bei Sourceforge unter https://sourceforge.net/projects/twickitapiphp/

Als Alternative sei auch noch einmal die PHP-Klasse von Sascha Ohms genannt. Die das Ergebnis als XML liefert.

Immer Up-to-date

Vielleicht werden solche Wrapper auch für weitere Programmiersprachen (Java, Ruby on Rails, Perl, .NET, etc.) folgen. Über Erweiterungen oder Änderungen an der API informieren wir immer als erstes über den extra dafür angelegten Twitter-Account @twickit_api. Selbst wenn du selbst kein Twitter nutzt kannst du dort Updates per RSS abonnieren.

So, jetzt hast du zwei Möglichkeiten: Entweder selbst ein cooles Mashup programmieren oder ab ins Freibad! Die anderen warten schon.

Schlagwörter: API, Geokodierung, PHP, Programmierschnittstelle, Wrapper