Ein "Amarillo" ist ein gelb gekleideter Verkehrsregler, der auf Kuba Trampern eine möglichst passsende Mitfahrgelegenheit vermittelt.
Ebenso wie ein kubanischer Amarillo hilft auch dieser Amarillo-Dienst, passende Mitfahrgelegenheiten zu vermitteln. Mitfahrplattformen können Mitfahrangebote ihrer Nutzerinnen über die Amarillo-REST-API publizieren und so Reiseplanern oder Meta-Suchmaschinen zur Verfügung stellen.
Amarillo reichert diese Mitfahrangebote um die mutmaßliche Fahrtroute sowie entlang dieser liegenden Zustiegs- und Ausstiegspunkte an, so dass Reiseplaner für Mitfahrene gut erreichbare Treffpunkte vorschlagen können, die mit geringen Umwegen angefahren werden können, wie z.B. Parken-und-Mitfahren-Parkplätze, Bahnhöfe oder Bushaltestellen.
Für die einfache Integration in Reiseplaner stellt Amarillo die Mitfahrangebote aller publizierenen Mitfahrbörsen nächtlich als regionale GTFS-Feeds bzw. minütlich als GTFS-RT Feeds bereit. Der GTFS-RT-Feed enthält alle seit dem Vortag um Mitternacht hinzugefügten, aktualisierten oder gelöschten Mitfahrangebote als ADDED bzw. CANCELED TripUpdates. Die amarillo-spezifischen Erweiterungen werden in dieser Prototype-Extension definiert.
Die Nahverkehrsgesellschaft Baden-Würtemberg mbH als Betreiberin dieses Amarillo-Dienstes für die Mobilitätsdatenplattform MobiData BW ist offen für die Aufnahme weiterer Mitfahrplattformen. Möchte die Mitfahrplatfform minutenaktuelle Mitfahrangebote bereitstellen, sollte sie die carpool-POST/PUT/DELETE-Endpunkte für jede Aktualisierung eines Inserats aufrufen. Bei Interesse an einer Integration bzw. um den hierfür notwendigen API-Key zu erhalten, nehmen Sie gerne über Kontakt mobidata-bw at nvbw punkt de mit uns auf.
Die Dokumentation dieses Dienstes ist als OpenAPI-Dokumentation verfügbar. Der Quellcode ist unter AGPL-Lizenz in diesem Github-Repository einseh- und abrufbar.
Wichtig für den Erfolg einer Mitfahrplattform sind mehrere Faktoren:
Idealerweise sollte die Mitfahrplattform es selbst schaffen, eine kritische Masse an Inseraten im Einsatzgebiet bereitzustellen, so dass Inserierende auf ihre Angebote auch Nachfragen erhalten und Suchende passende und aktuelle Angebote finden.
Weitere Aspekte sind einfache und intuitive Bedienbarkeit, Berücksichtigung der Präferenzen von Nutzenden etc.
Um die Wahrscheinlichkeit erfolgreicher Vermittlungen von Anbietenden und Suchenden zu erhöhen, bietet das Land Baden-Württemberg mit der Plattform amarillo.mobidata-bw.de eine Lösung an, über die Mitfahrangebote einer Mitfahrplattform in weitere Auskunftsanwendungen integriert und intermodal mit dem ÖPNV verknüpft werden können. So können z.B. auch Fahrten, die nur eine Teilstrecke der gesuchten Verbindung abdecken, z.B. mit Bus und Bahn kombiniert und der bestgeeignete Zustiegs-/Ausstiegsort ermittelt werden. Voraussetzung dafür ist, dass die Mitfahrplattform nicht nur als geschlossene Plattform ihren eigenen registrierten Nutzern die Suche nach Inseraten ermöglicht, sondern diese Inserate, in pseudonymisierter Form, der zentralen Vernetzungskomponente Amarillo bereitstellt.
Um eine Mitfahrplattform bzw. die Inserate aus einer Mitfahrplattform in Amarillo integrieren zu können, muss diese die folgenden technischen Voraussetzungen erfüllen:
Die Mitfahrplattform muss eine Schnittstelle anbieten, die die folgenden Anforderungen erfüllt:
Integrationsaufwände auf Seiten von Amarillo lassen sich minimieren, wenn die bereitgestellte Schnittstelle das folgende Antwort-Format liefert:
{
"data": [
{
"id": "1234",
"agency": "mfdz",
"deeplink": "http://mfdz.de/offer/1234",
"stops": [
{
"id": "de:12073:900340137::2",
"name": "ABC",
"lat": 45,
"lon": 9
},
{
"id": "de:12073:900340137::3",
"name": "XYZ",
"lat": 45,
"lon": 9
}
],
"departureTime": "12:34",
"departureDate": "2022-03-30",
"lastUpdated": "2022-03-30T12:34:00+00:00Z"
},
{
"id": "1235",
"agency": "mfdz",
"deeplink": "http://mfdz.de/offer/1235",
"stops": [
{
"id": "de:12073:900340137::2", "name": "ABC",
"lat": 45, "lon": 9
},
{
"id": "de:12073:900340137::3", "name": "XYZ",
"lat": 45, "lon": 9
}
],
"departureTime": "12:34",
"departureDate": [
"saturday"
],
"lastUpdated": "2022-03-30T12:34:00+00:00"
},
...
]
}
Details zum Schema finden sich unter https://amarillo.mobidata-bw.de/docs.
Die Mitfahrplattform sollte eine Schnittstelle anbieten, die die folgenden Anforderungen erfüllt:
Übermittelt werden sollten ausschließlich Mitfahrangebote, deren Start- oder Zielort sich in Baden-Württemberg befindet und deren Erstellung bzw. letzte Aktualisierung/Bestätigung maximal 180 Tage zurückliegt.
Bei Interesse an einer Integration der Mitfahrangebote Ihrer Mitfahrplattform in den gebündelten Datensatz „Mitfahrangebote“ Baden-Württemberg nehmen Sie gerne Kontakt mit uns auf, um den hierfür notwendigen API-Key zu erhalten. Schreiben Sie hierfür an mobidata-bw@nvbw.de.