public-transport / friendly-public-transport-format

A format for APIs, libraries and datasets containing and working with public transport data.
Creative Commons Attribution Share Alike 4.0 International
122 stars 1 forks source link

redundant origin / destination / … information in journeys #34

Open juliuste opened 6 years ago

juliuste commented 6 years ago

Right now, journey objects can contain information like departure, arrival, etc. as a shortcut for journey.legs[first].departure or journey.legs[last].arrival.

Since the original idea of FPTF was to allow people to easily write software that works with different APIs "on-the-fly", this imposes a problem. If one API returns data that contains redundant information like this and another doesn't, this practically negates the interchangeability of the two sources (and therefore one of the major benefits in using FPTF). For this reason, it might make sense to agree on one common way to return journey information.

Both @derhuerst and me probably slightly favor not including any redundant information here (forcing people to look directly at the (first and last) legs), since this might prevent some misunderstandings (e.g. when the first/last legs are actually not as important, because they're just "walking" trips).

Opinions? Other proposals?

derhuerst commented 6 years ago

/cc @deg0nz