Glossary
- Advisory
- See BART Service Advisory or BSA.
- API
- Application Programming Interface (API) is a set of routines, data structures, object classes and/or protocols provided by libraries and/or operating system services in order to support the building of applications. In the case of the Legacy API, it is a set of programming calls that return XML data about the BART service and system.
- Associated Route
- Each line is made up of two routes, one north and one south. For a given route, the "associated route" is the other route that makes up the complete line (e.g. Route 2's associated route is Route 1).
- Available Schedules
- A list of all of the current schedules that are included in the Legacy API. This may include schedules that are no longer active, a current schedule, and an upcoming schedule, depending on what has been released, and if a new schedule has been finalized. Checking the available schedules via the API will provide the schedule number and the effective date of that schedule for each of the schedules included in the BART schedule system. Old schedules are periodically removed, so requests for dates in the past will return results from the oldest available schedule.
- BART Midnight
- A special designation for a time between BART schedules. Since BART runs from approximately 4 am until just after 1 am, the concept of "BART Midnight" is used to represent a time that is between BART schedules. Current it is set to 2:26 am, but in the future it may vary depending on the day of week or other factors.
- BART Time
- The BART schedule use a special clock that is greater than 24 hours. It runs basically from midnight until 2am the following day. This has implications with certain Schedule results.
- Bike Flag
- Designates if it is okay to bring bicycles on a specific train. This flag appears in arrive, depart, stnsched and routesched commands. Bicycles are restricted from some trains during peak commute due to space limitations. bikeflag = 1, bikes allowed. bikeflag = 0, no bikes allowed. Note: BART still maintains this flag, but currently there are no bike restrictions in the current schedule. For more information, please refer to BART Bike Rules.
- BSA
- BART Service Advisory. Messages entered by the BART Operations Control Center (OCC) to let BART riders know about conditions that could affect the BART system. These include delay messages, warnings of police action, equipment problems, etc. Service advisories are only issued if two or more trains are off schedule by more than 10 minutes.
- Bus Bridge
- Sometimes when service between two stations is interrupted in such a way that trains cannot get through, connecting transit partners will be brought in to shuttle people between the two stations.
- Color
- A text value for the line color of a particular train. Possible values are: BLUE, GREEN, ORANGE, RED, YELLOW, BEIGE, PURPLE and WHITE. (WHITE represents trains that were added and have not been given a specific line assignment yet and the BEIGE route does not currently have ETD data.)
- Consist
- Another word used for train within BART. The two terms are interchangeable.
- Dwell Time
- The amount of time a train spends at a station before continuing along the route, or returning back on the associated route on the line.
- Elevator Advisory
- Message detailing any current elevator outages within the BART system.
- Escalator Advisory
- Message detailing any current escalator outages within the BART system. [Coming to API in 2017]
- ETD
- Estimated Time of Departure. Specifies time remaining before a train leaves a station. Since most dwell times are less than 1 minute at non-terminus stations, ETD's are equivalent to Estimated Time of Arrivals (ETA's). For trains with less than 1 minute left before departure, the ETD data will show the time as "Leaving". The BART website and API exclusively use ETD (not ETA) for all data.
- Excursion Fare
- A special price for trips that start and end at the same BART station.
- Fare
- The cost of a trip between two stations on the BART system. Fares are calculated by planning a trip between the two stations using the same back-end processes that are used on the BART website. Trips starting from and ending at the same station will result in the Excursion fare. Fare information now includes a fare class (current all fares are "normal") and then various fares (cash, rtcclipper).
- Generic Route Schedule
- A schedule for a given type of day (weekday, Saturday or Sunday), but not tied to a specific date.
- Hexcolor
- A hexidecimal RGB color value for the line color of a particular train. These colors match the color scheme used on the BART website for the various lines. The Routes and Route Information commands return this in the <color> element. BART will work to make these consistent with the ETD data in future releases.
- Holidays
- On certain specified days, the BART system may run a special schedule that differs from the normal daily schedule. These special schedules are automatically used when determining a trip schedule.
- Limited Trains
- A trains that does not stop at all of the stations on a particular route. This may also be a short train. Limited trains will have " - Limited" after the name of the head station that is the actual terminus of the train, and are listed by that head station in results from the trip planner and ETD displays.
- Line
- An inclusive collection of stations between two endpoints. Lines do not have a direction, but are made up of two routes which are uni-directional inclusive paths between the two end stations. The API does not provide any information about lines, but only the component routes.
- Load Factor
- No longer supported due to inaccuracy. This was an estimate of how full the train might be at a specified station based on historical data not real-time conditions. The load factor was a positive number, if defined, or 0 if no load factor was available. The higher the number, the more crowded the train was expected to be. Only weekday schedules had load factor information available. Added trains (trains placed into service either to replace another train or to provide additional service) had no associated load factor.
- QuickPlanner
- QuickPlanner was BART's first station-to-station trip planner. It was originally developed to power a Palm OS app in 2001, then later ported to bart.gov, a Windows Mobile app, and the Legacy API where it powered hundreds of third party applications. QuickPlanner was retired in 2019.
- Platform
- This designates a specific area within the station for boarding trains. All stations have at least 2 platforms and some have more. Generally a platform is associated with a particular direction of travel, but in the event of a disruption to regular service, a platform may be used for other trains as needed. Thus is it generally not wise to show specific platforms in trip planning, or at least to mention that the rider "Always check destination signs and listen for departure announcements".
- Route
- A uni-directional inclusive collection of stations between two end stations. Each BART line has two routes associated with it, one for each direction. The lines are considered to run North and South. (Dublin/Pleasanton to Daly City is considered the South route for the DUBL-DALY line.) Routes have a name (Dublin/Pleasanton - Daly City), abbreviation (DUBL-DALY), routeID (ROUTE 11), number (11), color (#0099cc), holiday flag (0), and a number of stations (17).
- Route Number
- An identifier used to designate one of the two directions for a given line. Each line has two routes, each with its own number. The route number is a single number, while the routeID is the combination of the word "ROUTE" and the number. (e.g. the Millbrae/Daly City - Richmond route is routeID "ROUTE 8", and route number 8.)
- Route Schedule
- Provides a complete listing of all scheduled trips between all stations on a line in a specific direction (Northbound or Southbound). These are called using the route number
- Service Advisory
- See BART Service Advisory or BSA.
- Short Train
- A trains that does not run through all of the stations on a particular route. They will display a head station that is the actual terminus of the train, and will be designated by that head station in schedule and trip plan results.
- Special Schedule
- Occasionally BART has maintenance work or other situations that may affect certain trips. These messages provide information about which stations are affected and the dates and times when the special schedule might occur.
- Station Abbreviations
- Four letter codes that are used to uniquely identify a BART station. BART maintains a list of the station abbreviations.
- Station Closure
- In rare occasions, BART may shut down a station due to an emergency or due to safety concerns. At these times, riders will be directed via announcements and or signs as to what they will need to do. Often BART will set up bus bridges to ferry riders around a closure, or may run the trains through the affected station without stopping. In terms of the API, this might be reflected in a BSA or a special schedule announcement (if planned ahead).
- Station Schedule
- Provides all of the departure times for a specified station. Includes information on the route, the train head station, the departure time, the destination time at the terminus station, the train id, the train index, and the bike flag along with other station schedule information.
- Terminus
- A station at the end of a route. Trains typically sit at terminus stations for a brief period before starting a return trip on the other route that makes up the specific line.
- Train
- Three or more BART cars travelling along a route. The minimum size for a BART train is three cars, and the maximum is 10 cars. Trains are also sometimes called a consist. The term can be used interchangeably.
- Train Count
- The current number of active trains in the BART system.
- Train Head Station
- Each train has displays a destination station on the front, which is also used on the displays in the station, and for announcements made by the Train Operator This station is the final destination for the train on the current trip. It might differ from the route end station if the train is a short train. This is also referred to as the Train Headway.
- Train ID
- A unique identifier of a train within each schedule type. (e.g. These ids are unique to each Weekday/Saturday/Sunday schedules, but may be repeated across the different types.) This information can be used to match schedule and real-time information. Note: BART is still working on adding the Train ID information into the ETD real-time data.
- Train Index
- The trainIdx was an attempt to provide an incremental identifier of scheduled trains on a route. However, as BART increasingly adds, removes, replaces or diverts trains throughout the day, the method became unreliable and is no longer supported.
- Trip Time
- The total minutes a trip will take according to the BART schedule.