Open frankgerhardt opened 2 years ago
Das wäre aber was für nach dem 8. Mai 2022.
Wenn ich die anderen Anbieter integriere, würde ich das lieber im neuen Format machen, weil dann keine Nacharbeit.
Ok, auch für den Übergang aufs neue Format schlage ich vor, die Daten der neuen, weiteren Anbieter im neuen Datenformat zu übertragen. Der Consumer - das iframe UI - würde solange beide Formate parallel unterstützen. Bestehende Datenlieferanten können dann nach und nach aufs neue Format umsteigen. Für das neue Format schlage ich eine gewisse Namenkonvention vor, um aktuell relevante Dateien leicht zu erkennen; sowohl per Software als auch durch sortierte Auflistung der Dateien im Verzeichnis.
Vorschlag in der Art:
trips_<direction>_<eventname>_<startdate>[_<enddate>]_<agency>_<version>.json
Beispiel: trips_to_Duesseldorf_2022-05-08_blablacar_0.1.3.json
<direction>
: 'to', 'from' to indicate the direction of the trips to or from the event
<eventname>
: name of the specific event. example = Duesseldorf
<startdate>
: date string of first day of the specific event. example = 2022-05-08
<enddate>
: optional date string of last day of the specific event. example = 2022-05-08
<agency>
: 'bessermitfahren', 'blablacar', 'mifaz', 'ride2go' to name the agency for which the file is containing data. example = blablacar
<version>.json
: version string of the JSON data file format using a semantic versioning format. example = 0.1.3.json
Hintergründe:
[_<enddate>]
ist optional; insbesondere, wenn es nur das Event nur eintägig ist (Früh hin und später zurück). Bei mehrtägigen Events ist der letzte Tag anzugeben. (An späteren Tagen sind die Daten nicht mehr relevant und können archiviert/gelöscht werden)trips
lassen sich alphabetisch leicht alle Dateien dieses Typs erkennen und sie erscheinen nicht gemischt mit anderen Dateinamen im gleichen Verzeichnis. Ein spezielles Verzeichnis ausschliesslich nur für solche trips Informationen ist trotzdem empfohlen.Offene Fragen:
Hinweise zum Format der JSON Datei mit mehreren Angeboten:
Für die aktuelle "Demo" Version in DE sind diese Festlegungen weniger relevant, weil nur eine Zeitzone genutzt wird und auch die agencies im code schon fest hinterlegt sind. Obige Überlegungen sind für zukünftige transnationale Lösungen relavant.
Bisher wurden die Daten in diesem Format hoch geladen: https://github.com/mitfahrverband/mitfahr-api/blob/main/beispieldaten/json/trips_export_schema.json Das ist das Format wie Stadtnavi Herrenberg Mitfahrangebote bekommen hat.
In Zufkuft möchte ich dieses Format verwenden: http://amarillo.mfdz.de:8001/docs, siehe Components / Carpool. Das ist das Format wie bbnavi und stadtnavi generell in Zukuft Angebote bekommen werden.