car2go Blog


car2go Open API 1.0

Tags für diesen Beitrag: , ,

Update vom 6. Februar 2012:

Dieser Artikel behandelt eine veraltete Version 1.0 der OpenAPI.
Die aktuelle OpenAPI-Version gibt es unter car2go.googlecode.com.
Eine Übersicht der existierenden Apps gibt es auf der car2go Homepage.

Please find the latest OpenAPI version at car2go.googlecode.com.
Follow this link to find an overview of all apps on our car2go homepage .

Originalartikel:

Der Start von car2go in Austin rückt mit grossen Schritten näher und dies bedeutet natürlich auch, dass wir im Rahmen unserer Open API weitere Standort unterstützen müssen. Bei dieser Gelegenheit werden wir auch den aktuellen Beta Status der API offiziell beenden und dann die Version 1.0 der API zur Verfügung stellen.

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.

Verwandte Artikel

Dieser Beitrag wurde am Sonntag, 15. November 2009 um 13:39 Uhr veröffentlicht und wurde unter der Kategorie car2go abgelegt. Sie können die Kommentare zu diesem Eintrag durch den RSS-Feed verfolgen. Sie haben die Möglichkeit, einen Kommentar zu hinterlassen oder einen Trackback von Ihrem Weblog zu senden.

« Zum vorherigen Beitrag - Zum nächsten Beitrag »


9 Kommentare (Kommentar schreiben?)

  1. 1. Marcus St.

    Kommentar vom 17. November 2009 um 02:13

    Hallo,

    war zwar etwas knapp, aber die Android Anwendung Find2Car ist nun rechtzeitig zum Start in Austin im US Android-Market verfügbar.

    Einen guten Start in Austin!

    Marcus Stursberg

    (Ein Mail-Service bei API-Update wäre sehr angenehm ;) )

  2. 2. Helmuth Ritzer

    Kommentar vom 17. November 2009 um 21:20

    @Marcus St. War in der Tat sehr knapp. Umso mehr Dank für den schnellen Support.

  3. 3. Car2go: 200 Smart rollen fortan durch Texas

    Pingback vom 18. November 2009 um 20:51

    [...] bin ich über das Blog der Car2go Leute gestolpert. So wie es aussieht, gibt es da sogar eine tolle API, um Fahrzeuge ganz einfach mobil suchen und registrieren zu können, beispielsweise mit Android [...]

  4. 4. ydna

    Kommentar vom 06. Dezember 2009 um 15:52

    Hallo.

    Eine Wunschfunktion der API wäre, dass ich nach Übergabe meiner GeoKoordinaten das nächste car2go zurückbekomme. Also nicht die Luftlinie, sondern der direkte Fußweg.

    Leider würde die Wunschfunktion sehr wahrscheinlich die Server extrem auslasten.

    Grüße, ydna.

  5. 5. Daniel Kraft

    Kommentar vom 06. Dezember 2009 um 22:47

    @ydna:
    Ich hab das (fast) implementiert unter http://d9t.de/nearest. Nur die Anfrage an Google Maps für den Fußweg fehlt, weil ich das etwas krass fände, wenn das für jedes Car2Go ausgerechnet würde. Denkbar wäre das höchstens für eine explizite Anfrage für einen Car2Go. Dafür reicht mir aber bisher die normale Luftlinie.

    Wenn Dich die Theorie dazu interessiert, kannst Du Dich gerne per Mail melden (siehe “Kontakt”). Der Algorithmus dazu ist recht einfach.

    Der Code, wie man eine Umkreissuche implementiert, ist öffentlich:
    http://pypi.python.org/pypi/d9t.gis
    Der Code, wie man mit Google Directions (z.B. für Fußwege) redet, ist auch öffentlich:
    http://pypi.python.org/pypi/google.directions

    Beides von D9T. Wenn’s Fragen gibt, einfach melden.

    Viele Grüße
    Daniel

  6. 6. M. Kipp

    Kommentar vom 03. Mai 2010 um 15:43

    Hallo,

    wie steht es um die API-Weiterentwicklung in Bezug auf die Buchungsfunktionalität, für meine eigene Lösung.

    Leider wurden seit dem Release der Seite car2go.com technische Änderungen vorgenommen, die es nicht mehr erlauben, diese vom Mobiltelefon zu bearbeiten. Schade!

  7. 7. K. Kamph

    Kommentar vom 10. April 2011 um 03:01

    Könnten sie die URL für Hamburg angeben?
    http://www.car2go.com/api/V1.0/hamburg/vacant ist es ja offensichtlich nicht.

  8. 8. Marcus

    Kommentar vom 12. Mai 2011 um 19:43

    Unter http://code.google.com/p/car2go/wiki/index_v2_0 gibt es die Dokumentation der aktuellen API. Freie Autos für Hamburg liefert http://www.car2go.com/api/v2.0/vehicles?loc=hamburg

  9. 9. Tobias

    Kommentar vom 06. Januar 2012 um 22:48

    Bitte die API Blogs aktuell halten, das bringt nichts, dass ein Blogposter einem sagen muss, wie genau die aktuellen API Links heissen, oder wo die Doku zu finden ist. Wenns gar nicht geht, schliessen und auf Google verweisen!

Einen Kommentar hinterlassen