tags.csv

tags.csv

This file associates tags to students, guardians, routes, stops, buses, or schools. Tags can be any sequence of characters, including emojis.

Fields

category

The name of the category this tag will apply to. Has to be one of student, guardian, route, stop, bus, or school.

entity

The ID or number of an entity that belongs to the category above.
  1. If category is student, then this will be the student ID specified in students.csv
  2. If category is guardian, then this will be the guardian ID specified in guardians.csv
  3. If category is route, then this will be the route ID specified in routes.csv
  4. If category is stop, then this will be the stop ID specified in stops.csv
  5. If category is bus, then this will be the bus number
  6. If category is school, then this will be the school name

tags

A comma separated list of all tags to be applied to this entity. Enclose this list in quotation marks.
For a student, you may optionally define an emoji tag that will appear on the copilot. For the tag to appear on the copilot, it must consist of a single emoji in the Symbols and Pictographs Extended-A set. See the final example below.

Example CSV

category,entity,tags
bus,31,”maintenance”
bus,40,”maintenance,sped”
student,12345,”sped”
student,12346,”🩷

Example CSV viewed as spreadsheet


category
entity
tags
bus
31
maintenance
bus
40

maintenance,sped
student
12345
sped
student
12346
🩷

    • Related Articles

    • ridership.csv

      This file associates students defined in students.csv to the stops defined in stops.csv, and to the routes defined in routes.csv. Fields student_id Student id as per students.csv. stop_id Stop id as per stops.csv. route_id Route id as per routes.csv. ...
    • fobs.csv

      This file associates each student defined in students.csv with the number of his or her fob or other bus pass. Fields student_id student id as per students.csv. fob_number The number associated with the fob or other bus pass. Example CSV ...
    • stops.csv

      This file contains all stops for all routes in the system. Each row is a stop. Stops can be used on multiple routes, so each stop should only have one row in this file. If no latitude or longitude are provided, the system will attempt to resolve the ...
    • guardians.csv

      This file contains guardians for the students. Each row is a guardian. Required fields are id, name, and at least one form of contact information. "Children" is not a required field -- this is to accommodate special situations -- but normally each ...
    • routes.csv

      This file contains all the bus routes. Each row is a route (or run, depending on your system). Fields id Unique id for the route. Can be either text or a number. description Human friendly description of the route. start_time Time of day when the ...