Lines

Through the views in this section, we can organize the routes.

Lines and Routes

In this view, we can see all the lines and routes created, as well as add new lines and routes.

Create Lines

To add a new route, follow these steps:

• Click the New Line button in the top right corner.
• Fill out the form (fields with an asterisk are required). In the Name field, it's recommended to write a short name (e.g., L1, F2, 145, etc.). For the full name, use the Description field.
• You can also set parameters such as Vehicle Type, Line Code, URL, and Color.
• Click Save Line to save.

Edit/Delete Lines

To edit or delete a line, follow these steps:

• Go to the Lines tab, and in the actions of the line, click the Edit icon to access the Edit Line view.
• Edit the information and click Save Line to save.
• You can also click Delete Line to delete it.

Create Routes

Routes are created within each line, following the steps below:

• Click the Line in which you want to add a route to expand it.
• Click New Route inside the dropdown.
• Fill out the options form:
  • Code, Name, Description, and Route Address.
  • Active Route: Defines whether the route will appear as active when created.
  • Route in Google (GTFS): Defines whether it will be added to the agency's static GTFS when shared with Google.
  • Route in the App: Defines whether it will appear in the mobile app (only if this service has been contracted).
  • Anti-grouping: Adds a view on the driver's tablet to let them know how far ahead or behind they are from the vehicles ahead and behind.
  • Keep the counter at the end: Defines if the passenger counter does not reset at the end of the route for routes that allow passengers to remain on the bus.

Add Stops to the Route

Once we have filled in the text fields of the Route, we can start adding Stops on the same page. Just below the form, on the left, we will see a list of stops that we have previously created in the Stops section (see Create Stops).

The list of stops for the route (with the text Double-click or drag the Stop to add it) will be empty. This space will show the stops that are added to the Route.

We can add stops in any of the following ways:

• Double-clicking the stop in the list on the left.
• Dragging stops (drag&drop) from the list on the left to the list in the middle.
• Selecting it on the map and clicking the Add Stop button.

For each stop added to the list, we can also check the Ref box to define it as a reference stop for the line.

If we want to change the order of the stops, we can move or place a stop in any position in the list by dragging it (drag & drop) to the desired position. We can also delete a stop by clicking on it and pressing the icon in the stop list or clicking the Delete Stop button that appears when clicking on the stop in the map.

Modify the Route's Path

By default, the path is automatically created by Google Directions, but we can modify it ourselves in two ways:

• The first option is by clicking on the segment we want to modify and selecting the Change Path option from the dropdown. After selecting this option, we can click on the streets where we want the modified path to pass. Meanwhile, a window will appear on the right side with two buttons:
  • Save Saves the new path.
  • Cancel Cancels all changes and closes the path editor.
• The other option is by clicking on the segment we want to modify and selecting the Edit Points option. In this case, we will see the WayPoints marked with a pin and number:
  • By dragging each one, we can modify the Route.
  • By clicking on a WayPoint, we can Add a point after or Delete point.
  • In the lower right corner, an options window will also appear with the following buttons:
    • Save Saves all the WayPoints.
    • Clear Points Removes redundant or duplicate WayPoints.
    • Delete Points Deletes all WayPoints except the first and last, so we can start configuring the route from scratch.
    • Cancel Cancels all changes and closes the WayPoints editor.

Edit/Delete Routes

In the Lines and Routes view, we expand the Line that contains the Route we want to delete or modify. In the actions of the Route, click the pencil icon to access the Edit Route view.

In this view, we can edit the Route's information or click the Delete Route button in the lower left corner to delete it.

To edit or delete a route, follow these steps:

Route Timetables

The Route Timetables define when the bus arrives at a stop and when it departs from the stop. This is what we will call a Trip. Trips will help us create Shifts, to which we will later add a Calendar to assign a bus and a driver to each shift in the Scheduling tab.

In the Lines and Routes view, we expand the Line that contains the Route for which we want to add or edit the Timetables. In the actions of the Route, click the clock icon to access the Timetables view.

Add Schedules to the Route

To add Schedules to the route, follow these steps in the Schedules view:

• In this view, click on the button. The Create Trip controller will appear.
• To assign Schedules to a Stop, you can do it in two ways: manual or automatic:
  • Manual:
    • Write the arrival time and departure time for each Stop.
    • In the Calendar icon , select the calendar (previously created) to which this Schedule applies.
    • Click the save button .
    • Assign a code and destination for the trip and accept Create Trip.
    • Repeat the process and create as many trips as needed by clicking the button.
  • Automatic (this mode is more effective if we have many trips in a Route):
    • Write the arrival time and departure time in the Reference Stops (or Stations). By default, the first and last Stops are considered Reference Stops. We can choose more Reference Stops by checking the box on the left of each Stop.
    • Once the times for the Reference Stops are set, click the calculator icon next to the save button . This button will fill in all the empty times using an average calculation.
    • The arrows indicate whether the Stop allows boarding and/or alighting passengers, or neither. We call ghost stops those where neither boarding nor alighting is allowed. These stops will not appear on onboard displays.
    • In the calendar icon , select the Calendar (previously created) to which this Schedule applies.
    • Click the save button .
    • Assign a code and destination for the trip and accept Create Trip.
    • To create more trips automatically, open the trip by clicking on any of the times.
      • Click on the three dots button at the top right and select Copy Trip.
      • In the Copy Trip window, write the frequency at which the trip will repeat (every 10 minutes, for example), and select the start and end times.
      • Click on Create x trips to accept.

Each time you modify something manually in the trip (the name, calendar...), you need to click the save button for that trip.

Recalculate Trip

You can modify any schedule and click recalculate trip to have all schedules recalculated automatically.

Copy Boarding/Alighting

This option allows you to copy the boarding and alighting data from this trip to all others.

Filter View

The route's schedule screen displays a lot of data at once. To find and display a limited number of records, we use the filter bar at the bottom of the screen.

The filtering options are:

• By default, from 00:00 to 23:59: all trips between those two times will be shown. If we modify the hours, the list will be reduced to show only trips between those hours. We can also filter by Calendars.
• Filter by Reference Stops: Above the list of Stops, we have the Reference Stops selector. By clicking the arrow, we can select and view only the Reference Stops.

Incorrect Trips Correction Button

The system automatically detects any internal errors that may exist in trips. If it detects them, a button will appear that will allow us to correct them. Correct X Incorrect Trips

Other Options

In the bottom right corner, we find the Options menu. Here we can modify all the trips currently displayed on the screen at once (if they are filtered, with the filters mentioned earlier, only the visible ones will be modified).

• Change Calendars: In this window, we can replace, add, or remove calendars from the trips.
• Recalculate All Trips: If some times have been manually adjusted, this button will recalculate the times automatically or fill in the empty times.
• Change All Destinations: You can change the name of all destinations at once.
• Change All Codes: You can change all the Codes at once.
• Get Historical Stop Times: This tool allows us to get the average times of previous trips that are in the historical data. The tool performs the calculations based on data obtained from previous real trips. We can configure this filter with the following options in the contextual window:
  • Select a Calendar: Select the calendar from which we want to obtain data.
  • Omit Outlier Data: This option excludes data that is far outside the parameters we want to set. For example, it omits data from vehicles that have been ahead by more than 5 minutes or delayed by more than 10 minutes.
  • Add Maximum Trip Duration: To avoid a longer duration than desired, we can set a maximum trip duration.
  • Add Start and End Dates: This option allows us to choose only the data between these dates.
  • Click on Get times to see the results.
• Import / Export Data: With these options, we can Import and Export data from the selected routes.
• Delete All trips This button will delete all the displayed trips.

Events and Detours

On this screen we can create the Events and Detours that may eventually modify the route of a Route. To do so, we create the Detour by adding all the affected Routes, and then add it to the Event that we must also create.

Detours are variations of a route that we can save for future use. Events, on the other hand, are instances of a detour applied during a specific time period.

• Detour example: I remove a stop from a route
• Event example: City marathon

This separation is designed to encourage the reuse of Detours, since it is common for routes to be diverted in the same way regardless of the reason. Therefore, for a good workflow, it is recommended to first create the Detours and then assign them to Events.

Create Events

Events are found within the Lines and Detours subsection, inside the Lines section. An Event is used to apply one or more detours that will take place during a predetermined time period.

We can create an event by following the steps detailed below:

• Click New Event while on the Events tab of the Events and Detours view.
• Define the name and description of the Event.
• Select one or more Detours to be applied during the Event we are configuring.
• Select the Time, the hours of the day during which the Event will apply, and click Save . It is important to note that this time filter is indicative and can be modified later from the Schedules view.

Create Detours

Detours are found within the Lines and Detours subsection, inside the Lines section. They allow us to temporarily change a route and then return it to its original state.

We can configure a detour by following the steps detailed below:

• Click New Detour while on the Detours tab of the Events and Detours view.
• Define the name and description of the Detour.
• Add all applicable Routes by clicking the button next to each route.
• Once the Routes are selected, the dashboard will open to edit and modify Routes. Modify the routes one by one as if they were regular routes (see section Modify the itinerary of a route). A modal window will appear with the text "Congratulations! The detour has been created".
• Click Next to add more Routes or Exit to finish the process of Adding Routes to the Detour. Routes can be added later as long as no event has been applied to the detour yet.
• In the general Detours view, you can edit the name of the Detour, see if it has applied events, or add Routes.

Actions within an Event

Schedule Events

We must configure the time intervals during which the event will be activated, following the steps detailed below:

• Click the calendar icon inside the Event.
• Set the dates and intervals for when the Event will take effect.
• Click the save icon next to each new interval.

In the general view we will see whether it is scheduled and whether it is active, meaning it is happening in real time.

It should be noted that the event dates are "subtracted" from the original calendar and kept by the event. The dates subtracted by the event can be seen within the original calendar under the Event Intervals section.

Add Detour

If we want to add more Detours to the Event:

• Click the button inside the Event.
• A modal will open; click the Select Detour button.
• Select the hours, which are again indicative and can be modified later from Schedules.
• Click Save .

Edit Event

If we want to change the name or description of the Event, we do so from the button within the Event actions.

Actions within a Detour that is already inside an Event

Configure Trips

Once we configure trips in the event, the event with the detour will be ready. It is done by following the steps detailed below:

• Click Configure Trips next to each Route contained in the Event.
• Select the Calendar it applies to in the trips column.
• Schedules can also be modified if necessary.
• Click Save to save.
• Repeat for each of the Routes.

Edit/View configured trips

If we have already configured the trips for the first time, the button within the detour actions that allows us to edit the schedules will appear. However, if the event already has an interval, we will not be able to modify those schedules and that button will change to view-only .

Create Alerts

An Alert is a notice for the users of the transport system. Once the Event is planned, we can configure an alert by clicking on the megaphone icon that will appear in the Detour actions within the Event:

• Click on the megaphone icon .
• We will have three options to configure, depending on where we want the Alert to be played:
  • Google: We need to specify the Title and Message of the Alert in each selected language. We can also provide a URL for more information.
  • Bus Screens: We need to specify the Title, the Alert Message in each selected language, and assign a Playback Time. We can also provide a URL for more information.
  • Bus Speakers: We need to specify the Title, the Message, and the Voice of the Alert in each selected language, and assign a Playback Time or specify every how many Stops it repeats. We can also provide a URL for more information.
• Click on to save.

Event Visualization on the Map

It is displayed when a Detour is happening in real-time and is visualized on the map as a dashed line.

Routes Without Line

They work exactly like routes with a line, but without being part of a Line. They can be created by following these steps:

• Click on New Route .
• A dialog window will open to edit and modify Routes. We create a new Route as if it were a normal route (see the section Edit/Delete routes).
• Click on Save route to save the route.

Line Axes

Axes are routes covered by two or more Routes in the same direction. The importance of Axes lies in the frequency with which vehicles pass. Axes can be controlled in real-time from the Line Scheme.

New axes can be created by following these steps:

• In the Line Axes section, click on New Axis .
• A window will open where we add an origin and a destination stop. Once the two are selected, the Lines and Routes dropdown will appear. From this dropdown, select the Routes to include in the Axis, and they will be added to the right list of Selected Routes.
• Click on Save .