stopover type

[juliuste]

Probably the most important feature FPTF is missing at the moment (IMHO) is the possibility to express departures and arrivals at a specific station (almost every public transport API has an interface for this).

I therefore propose a new type that could look like this (using fptf@1 keywords, disregarding the discussions in #27, #33 or #34 about possible changes in fptf@2 for now).

{
    type: 'stopover', // alternative proposals: 'arrival', 'departure', but this could be misleading since the accurate term in english would be "arrival or departure"
    station: '12345678', // station/stop object, required, name could be misleading since stops should also be valid. maybe 'halt' would be a better name - or two different keys "station" and "stop", but that's also probably not the best solution
    platform: '4-1', // string, optional
    arrival: '2017-03-17T15:00:00+02:00', // ISO 8601 string (with destination timezone), required if `departure` is null
    arrivalDelay: -45, // seconds relative to scheduled arrival, optional
    departure: '2017-03-16T20:00:00+01:00', // ISO 8601 string (with station/stop timezone), required if `arrival` is null
    departureDelay: 120, // seconds relative to scheduled departure, optional
    schedule: '1234', // schedule id or object
    mode: 'train', // see section on modes, overrides `schedule` mode
    subMode: …, // reserved for future use, overrrides `schedule` subMode
    public: true, // publicly accessible?, overrides `schedule` public
    operator: 'sncf' // operator id or operator object, overrides `schedule` operator
}

Any opinions / further proposals?

[derhuerst]

station: '12345678',

I'm in favour of stop, as it would be consistent with route.

`platform: '4-1',

Some means of transport, including some ferries and trains, have different platforms on arrival and on departure. Although I'm usually in favour of keeping things simple, in this case platform would convey something wrong essentially.

Therefore I'd propose departurePlatform and arrivalPlatform, which would be consistent with journey.

mode: 'train',

This should be required, right?

[juliuste]

I'm in favour of stop, as it would be consistent with route.

Agreed.

Some means of transport, including some ferries and trains, have different platforms on arrival and on departure. Although I'm usually in favour of keeping things simple, in this case platform would convey something wrong essentially.

Therefore I'd propose departurePlatform and arrivalPlatform, which would be consistent with journey.

Agreed.

mode: 'train',

This should be required, right?

Agreed.

😄