jokull/README.md

26 lines
1.2 KiB
Markdown
Raw Normal View History

# Jokullbase
How to track how late buses are:
- [ ] Download bus route data
- [ ] Insert raw bus positions into timescaledb/postGIS table?
- [ ] "Fan-out" JSON responses into one DB row per datapoint.
- [ ] Download routes.
- There is an endpoint called Timetable, which takes a route number
(along with day of week etc).
- The timetable response includes a list of stops in the route,
along with the route ID.
- There is an endpoint called **BusLocationByStop**, which takes a
stop ID as a parameter.
- This information has upcoming arrivals, included estimated
arrival time, along with the current position of the bus.
- Record stop info every few minutes, notably the arrivals.
- [ ] Analyze actual arrival vs what the stop endpoint said about the
arrival.
- Use PostGIS to compute "bus arrived" event: When bus is within X
meters of a stop on its route, mark that as an arrival event.
- Once we have bus arrival events, we can compare them to arrivals
throughout the day.
- We can then discard the raw bus position data, as it's not needed
to store it: delete every raw data point between the last arrival
and the newly computed one.