Was ändert sich aber nun konkret? Zuerst einmal werden alle Schnittstellen der Beta Version in der Übergangsphase weiterhin unterstützt. Dies bedeutet, dass z.B. alle heutigen Applikationen weiterhin ohne Problem laufen soweit sie sich auf die Beta Version der API beziehen

Mit dem Start des Piloten in Austin wird die API in zwei wesentlichen Punkten angepasst:

• die API wird um eine Versionsnummer erweitert um zukünftig die Abwärtskompatibilität der API sicherzustellen
• die API wird um den Standort des car2go Geschäftsgebiets erweitert um zukünftig weitere Standorte von car2go dediziert anfragen zu können (freie Fahrzeuge, Parkspots, Tankstellen, etc.)

Was die Versionierung der API betrifft, so wird es hier im wesentlichen zwei Typen von Versionen geben: Major und Minor Releases. Während Major Releases neue generelle Funktionalitäten beinhalten (z.B. Sofortbuchungen), werden Minor Releases nur kleinere Änderungen beinhalten. Generell werden wir versuchen im Rahmen der API nur Major Releases einzuführen um hier maximale Stabilität zu erzielen und Kompatibilitätsprobleme zu vermeiden. Alte Versionen werden soweit dies möglich ist, für eine Übergangszeit (3-6 Monate) weiter unterstützt und sind mit Erscheinen einer neuen Version automatisch auf “deprecated” gesetzt, was letztlich bedeutet, dass diese Version nicht länger eingesetzt werden sollte und nur für eine Übergangszeit weiter unterstützt wird.

Hier eine Übersicht der API mit den neuen Signaturen:

Freie car2go

ALT:
http://www.car2go.com/api/vacant

NEU:
http://www.car2go.com/api/V1.0/ulm/vacant
http://www.car2go.com/api/V1.0/austin/vacant

car2go Parkplätze

ALT:
http://www.car2go.com/api/parking

NEU:
http://www.car2go.com/api/V1.0/ulm/parking
http://www.car2go.com/api/V1.0/austin/parking

car2go Tankstellen

ALT:
http://www.car2go.com/api/gas

NEU:
http://www.car2go.com/api/V1.0/ulm/gas
http://www.car2go.com/api/V1.0/austin/gas

Reserviertes car2go

ALT:
http://www.car2go.com/api/reserved/<code>

NEU:
http://www.car2go.com/api/V1.0/ulm/reserved/<code>
http://www.car2go.com/api/V1.0/austin/reserved/<code>

<code> muss hierbei durch den individuellen Buchungscode ersetzt werden. Diese Schnittstelle liefert für jeweils 30 Minuten (15 Minuten vor und 15 Minuten nach einer Reservierung) die aktuelle Position des reservierten car2go. Hiermit sollte das finden von Fahrzeugen auch in den verwinkelsten Orten möglich werden.

Die Version 1.0 der car2go Open API stellt aber nur einen Zwischenschritt dar zu dem was wir Anfang nächsten Jahres geplant haben. Ziel ist es natürlich zu allererst die bisher vermisste Buchungsfunktionalität zur Verfügung zu stellen. Aber wir denken insgesamt an weitere Features die car2go wieder ein Stück nützlicher und einzigartiger machen.

Wie immer gilt auch hier, dass wir auf eure Kommentare sehr gespannt sind und insbesondere auf weitere Ideen was wir im Rahmen der Open API noch tun können. Insbsondere würde uns interessieren welche Community Features Ihr gerne sehen würdet.

Die car2go API orientiert sich ist in ihrer jetzigen Version an dem REST Paradigma, was eine sehr einfache und konsistente Nutzung über allen Plattformen hinweg zulässt. Zur Nutzung der API sind ausser der Möglichkeit einen HTTP Aufruf zu formulieren keine weiteren Voraussetzungen notwendig. Dies geht soweit, dass API Aufrufe direkt in Applikationen wie Google Maps eingegeben werden können. Dazu aber später mehr.

Momentan besteht die car2go API aus 4 verschiedenen Funktionen die im wesentlichen die Suche von car2go Fahrzeugen, Parkplätzen und Tankstellen unterstützen. Alle API Aufrufe liefern daher eine KML Struktur zurück, die entweder auf unsere Fahrzeuge oder eben die angesprochenen Parkplätze und Tankstellen verweist.Generell haben alle API Aufrufe folgende Struktur

http://car2go.com/api/function/

wobei function die eigentliche Funktion bezeichnet. Je nach Funktion enthält diese weitere Parameter. Dazu gleich mehr.

Position alle freien car2go

Als erstes wollen wir uns die Positionen aller “grünen” car2go, also der freien Fahrzeuge, ausgeben lassen. Folgender Aufruf liefert das gewünschte Ergebnis.

http://car2go.com/api/vacant/

Zum Test der Funktion eignet sich wie immer Google Maps, welches durch Eingabe dieser Funktion in das Suchfeld für uns den Aufruf durchführt und die resultierende KML Struktur sofort in de Karte anzeig. Zu beachten ist hierbei, Google Maps zeigt maximal nur 100 Fahrzeuge in Karte an, was aber kein Problem darstellt, wenn man in die Karte zoomt.

Die Funktion liefert eine Standard KML Struktur zurück die um einige spezifische Daten erweitert wurde.

<ExtendedData>
<Data name="fuel">
<value>95</value>
</Data>
<Data name="interior">
<value>GOOD</value>
</Data>
<Data name="exterior">
<value>GOOD</value>
</Data>
</ExtendedData>

So kann von jedem Fahrzeug der Zustand als auch der Füllstand des Tanks in Erfahrung gebracht werden. Der Tankfüllstand liegt hierbei zwischen 0-100, der Zustand wird mit den Werten EXCELLENT, GOOD, ISSUESEXIST, INACCEPTABLE repräsentiert. Man beachte hierbei den Schreibfehler beim schlechtesten Zustand, der korrekterweise UNACCEPTABLE heissen müsste. Bei der Interpretation dieser Werte bitte  beachten, daß wir in einer späteren Version der API diesen Wert ändern.

Um die Funktion direkt in Google Maps nutzen zu können enthält das <description></description> Tag eine Zusammenfassung dieser Werte zusammen mit der Fahrzeugadresse.

Momentan wird die Liste der freien car2go übrigens einmal pro Minute ermittelt, was genau genug sein sollte um nicht fälschlicherweise ein bereits vergebenes car2go anzusteuern.

Position aller car2go Parkplätze

Bisher nur auf der car2go Website als PDF Dokument verfügbar, sind jetzt alle offiziellen car2go Parkplätze auch als KML Struktur dokumentiert.

http://car2go.com/api/parking/

Auch hier kann der Aufruf wieder direkt in Google Maps eingegeben werden um z.B. die Parkplätze direkt anzuzeigen. Momentan zwar noch nicht möglich wird in Kürze die aktuelle Belegung der einzelnen Parkplätze als ExtendedData verfügbar sein.

Position der car2go Tankstellen

Als kleiner Service für alle die in die Situation geraten ein car2go in Ulm betanken zu müssen. Folgende Funktion liefert alle Shell Tankstellen in Ulm.

http://car2go.com/api/gas/

Position eines reservierten Fahrzeuges

Eines der neuen Features welches so bisher noch nicht machbar war, ist die Position eines reservierten Fahrzeuges zu ermitteln. Wie bisher üblich wird man 15 Minuten vor der Reservierung via SMS über das Kennzeichen des Fahrzeuges und den Fahrzeugstandort informiert. Aufgrund der rein textuellen Fahrzeugposition kann es mehr oder weniger schwierig sein das reservierte car2go zu finden.

Hier hilft in Zukunft eine API Funktion die mit Hilfe eines Buchungskodes das reservierte Fahrzeug eindeutig identifiziert. Der Buchungskode wird mit der Reservierungs SMS 15 Minuten vor der Reservierungszeit an den Kunden geschickt. Folgende Funktion liefert zuverlässig die Position des reservierten Fahrzeuges.

http://car2go.com/api/reserved/code

wobei code durch den eigentlichen Buchungskode ersetzt werden muss. Zu beachten ist, dass der Buchungscode nur 15 Minuten vor and nach der Buchung gültig ist und dann verfällt.

Soweit die bereits heute zur Verfügung stehenden Funktionen der car2go API, die wir im Laufe der Zeit um weitere Funktionalitäten erweitern werden. Zu beachten ist hierbei, daß sich die aktuelle API immer noch im Beta Status befindet. Dies bedeutet, dass sowohl die Implementierung als auch die Funktionalität noch kleinen Änderungen unterworfen sein wird. Generell gelten bei der Verwendung der API unsere Nutzungsbedingungen, die jederzeit unter car2go.com/api/tou.htm aktuell eingesehen werden können.

Tools und Helfer

Obwohl die car2go API in erster Linie für Entwickler gedacht ist, besteht trotzdem die Möglicheitdiese direkt zu verwenden. Hier eine kleine Zusammenstellung nützlicher Tools und Helfer

• Freie cargo in Google Maps (http://tr.im/freecar2gogm)
• car2go Parkplätze in Google Maps (http://tr.im/parkcar2gogm)
• car2go Tankstellen in Google Maps (http://tr.im/gascar2gogm)

Um mit dem Smartphone sein freies car2go zu finden bietet sich Google Maps Mobile an, welches auf fast jedem Java ME fähigen Handy einsetzbar ist. Einfach im Browser des Smartphone http://google.de/gmm/ eingeben und die Applikation installieren. Nach der erfolgreichen Installation kann ähnlich wie bei Google Maps in der Suchmaske die jeweilige Funktion eingegeben werden. Zu beachten ist hierbei, daß die Funktion mit führendem http:// eingegeben wird.

Um auch hier die Nutzung zu vereinfachen hier die dazu notwendigen Links in verkürzter Form

• http://tr.im/freecar2go
• http://tr.im/parkcar2go
• http://tr.im/gascar2go

Letztlich sind wir aber alle auf die zahlreichen Applikationen gespannt die basierend auf der API car2go noch einfacher nutzbar macht.

Viel Spass dabei …

P.S. Anmerkungen, Fragen und hoffentlich keine Bugs hier einwerfen

Jedes car2go ist mit einer Tankkarte und einer Parkkarte ausgestattet. Beide Karten finden sich normalerweise im Handschuhfach in einem speziell dafür vorgesehenen Halter. Mit Hilfe eines Siegels auf den Karten (ähnlich dem car2go Siegel auf dem Führerschein) kann das car2go System zu jeder Zeit das Vorhandensein beider Karten im Kartenhalter prüfen. Dies dient in erster Linie dazu, dass Karten wieder ihren Platz finden und der nächste Kunde nicht das Fahrzeug nach ihnen durchsuchen muss. Befindet sich am Ende der Nutzung mindestens eine dieser  Karten bzw. der Zündschlüssel nicht im angesprochenen Halter weist einerseits der Bildschirm im Fahrzeug als auch der Kartenleser an der Windschutzscheibe auf diesen Umstand hin und die Miete kann logischerweise so lange nicht beendet werden bis alle Karten als auch der Schlüssel an Ort und Stelle sind. Soweit die Theorie.

Seit dem Start des internen Piloten Ende Oktober 2008 hat sich dieses System bewährt und wir waren uns sicher, dass wir an dieser Stelle nicht mit Problemen rechnen mussten. Es kam aber dann doch ganz anders. Relativ kurz nach Öffnung des Piloten auf die Ulmer Bevölkerung bekam unser Service Center vermehrt Anrufe von Kunden die Aufgrund einer nichtmehr vorhandenen Tank- bzw. Parkkarte Ihre Miete nicht beenden konnten. Das Problem dabei war nur, dass beide Karten laut Kundenaussage im Kartenhalter steckten. Nachdem wir uns mehrere dieser Fälle genauer angeschaut hatten stellten wir fest, dass in nahezu allen Fällen die Parkkarte nichtmehr durch das System erkannt wurde. Auffällig war ebenfalls, dass in allen Fällen, das Siegel auf der Parkkarte optisch einwandfrei war, jedoch nichtmehr vom Kartenleser erkannt wurde. Soweit so gut, aber wer oder was zerstört die Siegel der Parkkarte in nicht unerheblicher Anzahl?

Nach Analyse aller Fakten und insbesondere der Tatsache, dass bisher nur Parkkarten zerstört wurden deutete vieles darauf hin, dass bei der Nutzung der Parkkarte irgendetwas schief geht. Nachdem wir uns die Situation vor Ort angeschaut hatten, kam der leise Verdacht auf, dass Kunden die Parkkarte bei der Ein- und Ausfahrt nicht wie vorgesehen in das rote SchwabenCard Terminal stecken, sondern in den normalen gelben Ticketspender bzw. -leser. Mehrere Tests bestätigten schliesslich unsere Vermutung. Wahrscheinlich aufgrund eines nicht unerheblichen elektrischen Feldes in den Ticketlesern wird das auf der Parkkarte angebrachte Siegel zerstört und verursacht letztlich die Probleme beim Beenden der Miete.

Nur wie löst man dieses Problem? Konstruktiv lässt es sich leider nur sehr schwer verhindern, dass Kunden aus Versehen die Karte in den falschen Schlitz stecken. Die Karte hat das gleiche Format wie die eigentlichen Parktickets. Letztlich kann bis auf weiteres nur durch weitere Kundeninformationen bzw. durch eindeutige Bezeichnungen auf den Parkautomaten  das Risiko einer Falschbedienung minimiert werden. Ganz lässt sich aber eine mögliche Fehlbedienung leider nicht beseitigen. Oder hat einer unserer Kunden eine zündende Idee?

Was man aber an diesem Beispiel wiederum gut sehen kann, es sind typischerweise die kleinen Dinge die man eigentlich geglaubt hatte im Griff zu haben, die einem Probleme bereiten.

Letztlich muss man sagen, dass wir die richtigen Entscheidungen getroffen haben und durch gezielte kleinere und größere “Releases” einige von den Funktionalitäten nachgezogen haben, die wir seit Beginn schmerzlich vermissten. Eines der “Features”, das aufgrund der Zeitleiste bis heute auf sich warten lässt, ist die weitgehende Unterstützung so genannter “Smart Phones”, also Geräte der neusten Generation, die jederzeit online sind und durch ihr eingebautes GPS Module den Standort ihres Besitzers kennen. Das iPhone als ein wichtiger Vertreter dieser Generation von Mobiltelefonen hat sehr deutlich gezeigt was hier möglich ist. Dutzende von kleinen Applikationen im Apple AppStore zeigen, wie durch intelligente Nutzung einer aktuellen GPS Position mehr und mehr standortbezogene Dienste entstehen – engl. “Location-based Services”. Durch die Einbeziehung des aktuellen Standorts des Nutzers wird eine stärkere Personalisierung von Dienstleistungen ermöglicht. “Mashups” – also die Kombination zwei oder mehrere solcher Location-based Services sind heute das Salz in der Web 2.0 Suppe und ermöglichen Dienstleitungen, die vor Jahren nur mit sehr hohem Entwicklungsaufwand und teurer Hardware machbar waren.

Was liegt also näher als car2go, d.h. Carsharing 2.0, mit dem Web 2.0 zu verbinden? Genau das haben offensichtlich auch unsere Kunden erkannt, und nicht allzu lange nach unserem öffentlichen Start in Ulm Ende März gab es erste private und öffentliche Experimente in diesem Umfeld.Prominentester Vertreter dürfte hier ohne Zweifel car2go Nutzer-der-ersten-Stunde Daniel Kraft sein, der an dieser Stelle vor zirka einem Monat seinen car2go Finder vorgestellt hat. Nicht nur, dass Daniel Kraft seinen car2go Finder allen car2go Nutzern zur Verfügung stellt, er hat auch einen sogenannten KML Feed aller “grünen” car2go (so bezeichnen wir intern die freien Fahrzeuge) für interessierte Anwender bereitgestellt. Das Geniale daran ist, dass man mit jeder KML-fähigen Anwendung diese Daten nutzen kann. So kann sich ein iPhone oder Blackberry Besitzer ganz einfach alle freien car2go anzeigen lassen und darüber hinaus den Weg von seinem aktuellen Standort zum gewünschten Fahrzeug anzeigen lassen.

Alles was dazu benötigt wird ist ein Java-fähiges Mobiltelefon und Google Maps Mobile. Einfacher geht es wie immer mit dem iPhone, da hier Google Maps bereits vorinstalliert ist. Nun einfach den Link auf den KML Feed (http://d9t.de/nearest/kml) in die Google Maps Suchzeile eingeben und voilá – alle freien car2go in einer Hand! Es ist schon beeindruckend, welch mächtiges Tool man dadurch bekommt. Neben Google Maps existieren dutzende weiterer KML-fähiger Anwendungen, die mit den car2go Daten gefüttert werden können. Auch von dieser Stelle nochmals meinen ausdrücklichen Dank an Daniel Kraft für sein nicht unbeträchtliches Investment.

Doch das ist nur der Anfang. Warum nicht die Liste der freien car2go weiterverarbeiten? Möglich ist dies auch ohne spezielle Programmierkenntnisse durch ein weiteres Web 2.0 Tool namens Yahoo Pipes. Mit Hilfe einer graphischen Oberfläche kann der interessierte Anwender unterschiedliche Datenquellen vom Typ RSS oder KML einlesen, verarbeiten und einfach mit weiteren Informationen kombinieren und anreichern. Am Ende können die “veredelten” Daten wiederum öffentlich bereitgestellt werden. Die Möglichkeiten sind hier nahezu grenzenlos.

Offizielle Open API

Bei aller Begeisterung für den “inoffiziellen” Service von d9t.de, so gibt es doch einige prinzipbedingte Einschränkungen, die nach einer besseren Lösung rufen. Momentan holt sich der Service die Positionen der freien car2go direkt von der car2go Website, wo sie im Rahmen unserer “Teaser Map” dargestellt werden. Problem Nummer 1 hierbei ist die Aktualität der dort sichtbaren Daten. So werden die Positionen der freien car2go aus Performanzgründen nicht bei jedem Seitenaufruf neu ermittelt, sondern über einen Zeitraum von 10-15 Minuten zwischengespeichert. Es kann also passieren, dass man ein Fahrzeug auf seinem Smart Phone sieht, das in Wahrheit schon besetzt bzw. reserviert ist. Problem Nummer 2 sind die wenigen Angaben zu den car2go, die über die eingebettete Teaser Map verfügbar sind. Außer der Position unterscheiden sich die Fahrzeuge nicht. Wäre es nicht besser neben dem Nummernschild, den Tankfüllstand und die Fahrzeugbewertung zu erhalten? Am Ende aber krankt die aktuelle Lösung an Problem Nummer 3, der Tatsache, dass wir morgen entscheiden könnten sowohl die Teaser Map zu entfernen (welche sowieso nicht sehr gut lesbar ist) bzw. das Format der Daten zu ändern. Es geht dabei nicht darum den Nutzern draußen das Leben zu erschweren, aber Software entwickelt sich weiter und so wird sich auch unsere car2go Website weiterentwickeln.

Die Lösung für alle diese Probleme ist aber vieleicht näher als gedacht. Im Rahmen unserer Release Planung haben wir eine Mobile Roadmap verabschiedet, die unter anderem eine offene Schnittstelle beinhaltet. Die folgenden unverbindlichen Meilensteine daraus möchte ich hier kurz vorstellen.

Meilenstein 1: Offizieller KML Export – Mitte Juni 2009

Beginnen werden wir als Teil der car2go Open API mit dem vollständigen Feed aller “grünen”, also freien car2go, inklusive deren Nummernschild, Standort in Form einer Adresse, dem Tankfüllstand und dem Zustand des Fahrzeuges. Dieser Export im KML Format wird so aktuell wie möglich zur Verfügung gestellt und kann zukünftig Anwendungen mit offiziellen car2go Daten versorgen.

Neben den reinen fahrzeugbezogenen Daten, werden zusätzlich alle car2go Hotspots, also unsere speziell markierten Parkplätze, mit ihrer Kapazität und aktuellen Belegung bereitgestellt.

Last but not least, werden alle car2go Partner Tankstellen in einem weiteren KML Export bereitgestellt. Ich bin schon jetzt auf die ersten Anwendungen gespannt, die sich diese Daten zu nutze machen.

Aber das ist noch nicht alles! Aufgrund zahlreicher Rückmeldungen unserer Kunden, haben wir uns entschlossen neben den freien car2go, auch die Position von reservierten Fahrzeugen im KML Format bereitzustellen. Da reservierte car2go bis 15 Minuten vor der eigentlichen Reservierung noch nicht endgültig feststehen und diese Daten auch nur im Rahmen der spezifischen Reservierung Sinn machen, sind die Daten nur mit Hilfe eines individuellen Schlüssels zugreifbar. So wird jeder Kunde im Rahmen seiner Reservierung zukünftig im Portal bzw. in der Bestätigungs-SMS ein Reservierungs-Token erhalten. Mit Hilfe dieses Tokens kann dann 15 Minuten vor und 15 Minuten nach dem eigentlichen Reservierungstermin die Position des zugeteilten car2go genau erfragt werden. Diese Informationen sind zu dem Zeitpunkt momentan nur direkt im car2go Portal einsehbar.

Mit Hilfe der beiden Schnittstelle kann sehr einfach ein Mobile Carfinder entwickelt werden, der zum einen freie car2go, aber auch reservierte car2go anzeigen kann. Was uns direkt zu unserem nächsten Meilenstein führt.

Meilenstein 2: car2go Mobile Carfinder – Q3/2009

Während wir mit Meilenstein 1 sehr konkret unterwegs sind, ist die Planung bzgl. der weiteren Meilensteine noch relativ vage. Ziel ist es hier einen originären car2go Car Finder zu entwickeln, der die zu diesem Zeitpunkt bereitgestellten APIs nutzt und sie in geeigneter Weise dem “normalen” car2go Nutzer nahe bringt.

Ich möchte trotzallem hier explizit dazu aufrufen eigene Anwendungen z.B. für das iPhone zu entwickeln. Es ist in unser aller Interesse, wenn hierbei um die Wette programmiert wird. Ich bin mir sicher, dass insbesondere durch die Verknüpfung verschiedenster Datenquellen der Mobilitätsbedarf unserer Nutzer noch besser bedient werden kann. Letztlich sind das aber alles nur Vorbereitungen zu dem eigentlichen Ziel, ein mobil nutzbares car2go Portal zu ermöglichen.

Meilenstein 3: Mobiles car2go Portal – Q1/2010

Es ist Stand heute schwer zu sagen, wie ein solches mobiles car2go Portal genau aussehen wird, es ist aber davon auszugehen, dass neben dem eigentlichen Portal eine erweiterte API bereitgestellt wird, die es z.B. erlaubt Reservierungen durchzuführen oder Fahrten einzusehen. Bevor wir das jedoch ermöglichen, muss ein schlüssiges Sicherheitskonzept erarbeitet werden, das jeglichen Missbrauch dieser Schnittstellen verhindert.

Die Frage bei allen diesen Aktivitäten ist natürlich, was benötigt die car2go Community? Ich möchte hier die Gelegenheit nutzen alle Interessierten aufzurufen die Entwicklung von alle dem mitzugestalten. Schreibt eure Ideen, Wünsche und Anregungen in den Kommentaren. Wir sind sehr gespannt …