Rules When Creating Redrawing The Routes (WIP)

Updated 03/26/2024

Introduction

The first GPX waypoint does not start at the Union and there are only two routes, West and North. The implementation of the ETA algorithm will use this idea and thus future redraws/creations of routes should follow the following set of rules.

Waypoint of Union stays as last waypoints on West Route

Currently, the following 10 GPX waypoints are dedicated to just the loop that enters and exits out of the union's waypoint. The GPX waypoints of both routes are designed for drawing/readability purposes. The West route is drawn first followed by the East route. This allows it to flow into the waypoints of both of the routes.

        <rtept lat="42.730676" lon="-73.676552">
	</rtept>
	<rtept lat="42.730332" lon="-73.676657">
	</rtept>
	<rtept lat="42.730332" lon="-73.676657">
	</rtept>
	<rtept lat="42.730322" lon="-73.676659">
	</rtept>
	<rtept lat="42.730289" lon="-73.676455">
	</rtept>
	<rtept lat="42.730285" lon="-73.676426">
	</rtept>
	<rtept lat="42.730428" lon="-73.676377">
	</rtept>
	<rtept lat="42.730505" lon="-73.676350">
	</rtept>
	<rtept lat="42.730606" lon="-73.676315">
	</rtept>
	<rtept lat="42.730676" lon="-73.676552">

End waypoints are not starting waypoints

As stated before, the way that the routes work is based on drawing purposes. This means that it is not designed for algorithm work or waypoint manipulation. Currently, both routes will start from the Union, however, that does not mean that the last waypoints will also be at the Union. For the West Route, it will begin past the Union, but the last waypoints will be at the Union. The ETA algorithm will specifically use that idea where the first waypoints of the GPX file will not begin with the Union.

For the North Route, it will be the opposite of the West Route. It will start at the Union and the last waypoint will be away from the Union.

First 8 waypoints of North Route stays the same

The first 8 waypoints of the North Route should remain the same as the algorithm utilizes the fact that the first 8rtepts will be the same 8 rtepts listed below. The algorithm will start from the 8th rtept, the last rtept from the below list, to begin tracking the distance a bus has started traveling.

        <rtept lat="42.730606" lon="-73.676315">
	</rtept>
	<rtept lat="42.730505" lon="-73.676350">
	</rtept>
	<rtept lat="42.730428" lon="-73.676377">
	</rtept>
	<rtept lat="42.730285" lon="-73.676426">
	</rtept>
	<rtept lat="42.730289" lon="-73.676455">
	</rtept>
	<rtept lat="42.730322" lon="-73.676659">
	</rtept>
	<rtept lat="42.730332" lon="-73.676657">
	</rtept>
	<rtept lat="42.730676" lon="-73.676552">

Distinguish by request stops

There are some stops that the shuttles will stop only if passengers/students would like to get off at, otherwise, they will skip over it. One example of this is West hall on the West Route. Majority of the time, the driver will either skip it or ask if anybody is getting off there. Within the gpx file to create the route, there should be some description noting whether they are "No Request" or "Request Only". This can be done either as a description of each rtept or it can be any property of the rtept. There is currently a pull request to merge a piece of code implementing this property on the stops. Each time the gpx importing job is being done, this property will also be implemented.

North Route begins on Sage Ave

Route naming convention

The ETA algorithm relies heavily on the route names being "West Route" and "North Route". In the future, if naming does change whether the direction of the route changes or the full name changes, the entire algorithm will throw errors from many different methods that is used in the ETA algorithm. One solution is to leave the route names to always be the same. If for some reason the directions change, go back to the files Route.swift and TrackAverageSpeed.swift.