## 6.16 Transportation and Geographic Information Working Group

The goal of Transportation and Geographic Information Working Group is to provide the wealth of information currently locked in the transportation department to the rest of the school community, including transportation as well as geographic information for students.

Click here for non-normative background/supplementary documentation from this group.

### 6.16.1 BusEquipment

This object contains information about a type of equipment that may be on a bus. Examples include wheelchair, car seat, etc.

SIF_Events are reported for this object.

Figure 6.16.1-1: BusEquipment

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusEquipment |  | This object contains information about a type of equipment that may be on a bus. Examples include wheelchair, car seat, etc. |
@ | RefId | M | GUID that identifies this type of equipment. | RefIdType
| Description | M | Explanation about the type of equipment. | xs:string
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.1-1: BusEquipment
<BusEquipment RefId="D3E34B359D75101A8C3D00AA001A1652"> <Description>Wheelchair</Description> </BusEquipment>
Example 6.16.1-1: BusEquipment

### 6.16.2 BusInfo

This object contains all of the information about a bus.

SIF_Events are reported for this object.

Figure 6.16.2-1: BusInfo

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusInfo |  | This object contains all of the information about a bus. |
@ | RefId | M | GUID that identifies this bus. | RefIdType
| VehicleNumber | M | Vehicle number of the bus. | xs:normalizedString
| SeatingCapacity | O | The number of people who can ride on the bus at the same time. | xs:unsignedInt
| Contractor | O | The name of the contractor for this bus. | xs:normalizedString
| EquipmentList | O | Describes any special equipment that is on this bus. | List
| EquipmentList/Equipment | MR | Inventories each piece of special equipment on the bus. |
| EquipmentList/Equipment/BusEquipmentRefId | M | GUID that identifies the type of equipment. | IdRefType
| EquipmentList/Equipment/Count | M | The number of pieces of this type of equipment that are on this bus. | xs:unsignedInt
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.2-1: BusInfo
<BusInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <VehicleNumber>63</VehicleNumber> <SeatingCapacity>71</SeatingCapacity> <Contractor>RYDER</Contractor> <EquipmentList> <Equipment> <BusEquipmentRefId>E2F23A5323E87343B9A34BE457321E4A</BusEquipmentRefId> <Count>3</Count> </Equipment> <Equipment> <BusEquipmentRefId>34BE45E87343B9A5323A73212F23E7B3</BusEquipmentRefId> <Count>4</Count> </Equipment> </EquipmentList> </BusInfo>
Example 6.16.2-1: BusInfo

### 6.16.3 BusPositionInfo

This object exposes telematics information to the zone.

SIF_Events are reported for this object.

Figure 6.16.3-1: BusPositionInfo

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusPositionInfo |  | This object exposes telematics information to the zone. |
@ | BusInfoRefId | M | The GUID that identifies the bus. This object only has meaning as current data for this particular bus. | IdRefType
| Date | M | The date of the report from the bus. | xs:date
| Time | M | The time of the report from the bus. | xs:time
| GridLocation | M | The location of the bus. | GridLocation
| TelematicsId | O | ID of the hardware unit on the bus that tracks & reports location and status. The interpretation of the content is deployment specific, but the format must be compact. | xs:normalizedString
| TelemetryList | O |  | List
| TelemetryList/Telemetry | OR | Indicators and values provided by the hardware along with this position snapshot. For events, it is safe to assume that one of these items triggered the hardware to issue an update. The following values are suggested for common reports to enhance interoperability, but each deployment will have items dictated by the infrastructure. A format for reporting continuous-value metrics is also suggested. Suggested Values: Panic—panic button pressed Accident—airbag deployed or some other detection Checkpoint—manually triggered per procedures Assistance—non-emergency request Timer—timed report RouteStatus—change to RouteStatus/Status Open—door open Close—door closed ToD—shifted into "Drive" OffD—shifted off "Drive" StpLght—Stop Lights are on WrngLght—Warning lights are on StpArm—Stop arm is out CrsngGt—Crossing gate is extended EcmOp—ECM Oil Pressure is Low EcmOt—ECM Oil Temperature is high EcmTt—ECM transmission temperature is high EcmTp—Transmission Oil Pressure is low EcmFuelPrs—ECM Fuel Pressure is low EcmExtIdle—ECM Extended engine idle period EcmOvrSpeed—ECM engine over Speed EcmVltg—ECM Voltage is low OutBndry—Out of Boundary FuelGauge-34pct—suggested continuous-value syntax, minimal use of special characters | xs:normalizedString
| BusDriver | O | Information identifying the driver. |
| BusDriver/Name | C | The name of the driver. Condition is that at least one of this and EmployeePersonalRefId must be included. | Name
| BusDriver/EmployeePersonalRefId | C | The GUID of the driver's EmployeePersonal object. Condition is that at least one of this and BusDriver/Name must be included. | IdRefType
| BusDriver/Status | M | Boarding status of the driver. | values: On Driver boarded the bus and no exit detected Off Driver exited the bus Sched Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm who the driver is
| BusStaffList | O | List identifying other staff. This may include aides, nurses, proctors, etc. | List
| BusStaffList/BusStaff | OR | Information about an individual staff member on the bus. |
| BusStaffList/BusStaff/Name | C | The name of this staff member. Condition is that at least one of this and EmployeePersonalRefId must be included. | Name
| BusStaffList/BusStaff/EmployeePersonalRefId | C | The GUID of the employee's EmployeePersonal object. Condition is that at least one of this and BusStaff/Name must be included. | IdRefType
| BusStaffList/BusStaff/Status | M | Boarding status of this staff member. | values: On Boarded the bus and no exit detected Off Exited the bus Sched Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm this staff's identity
| RouteStatus | C | If the bus is running a route, this element must be included in the object. Absence means the bus is not operating a route. |
| RouteStatus/BusRouteInfoRefId | M | The GUID that identifies the route. | IdRefType
| RouteStatus/Status | M | Status of the route. | values: Begin No students have been picked up yet End All students have been dropped off Continue In the midst of a run
@ | BusRouteDetailRefId | O | If the bus is currently at a stop in this route, identify the stop's SIF object. | IdRefType
| OtherStatus | C | If the bus is not running a regularly scheduled route but is transporting (or positioning to transport) passengers as approved and directed by the school district, this element describes the activity. It's also used for maintenance, repair, and other authorized movements. This element is mutually exclusive with RouteStatus. Absence of both RouteStatus and OtherStatus is acceptable, but may indicate unauthorized operation. The following values are suggested to enhance interoperability, but the field is free-form. Suggested Values: Field Trip Sporting Event Support Services Maintenance Repair | xs:normalizedString
| Odometer | O | Current odometer reading. | xs:decimal
@ | Unit | M | Units used in the odometer reading. | values: km Kilometers m Miles
| Speedometer | O | Current speedometer reading. | xs:decimal
@ | Unit | M | Units used in the speedometer reading. | values: km Kilometers/hour m Miles/hour
| Students | O | A list of students and their statuses. The complete list may be sent with some events (e.g. change in RouteStatus) per district policy, but it is more typical of responses. | List
| Students/Student | OR | Each student's status. |
| Students/Student/StudentPersonalRefId | M | GUID that identifies the student that this element refers to. | IdRefType
| Students/Student/Status | M | Boarding status of this student. Note: Values `Sched`, `On` and `Off` are typical of responses. Values `Entered` and `Exited` are typical of events. | values: On Student boarded the bus and no exit detected Off Student exited the bus Entered Boarded the bus since previous event Exited Left the bus since previous event Sched Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm student identities
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.3-1: BusPositionInfo
<BusPositionInfo BusInfoRefId="A2E35B359D75101A8C3D00AA001A0000"> <Date>2003-10-13</Date> <Time>13:39:12-08:00</Time> <GridLocation> <Latitude>41.850000</Latitude> <Longitude>-87.650000</Longitude> </GridLocation> <TelematicsId>NexTel866-456-7890</TelematicsId> <TelemetryList> <Telemetry>Close</Telemetry> </TelemetryList> <BusDriver> <EmployeePersonalRefId>BB0300099D75101A8C3D00AA001A0000</EmployeePersonalRefId> <Status>Sched</Status> </BusDriver> <RouteStatus> <BusRouteInfoRefId>D3E34B359D75101A8C3D00AA001A1652</BusRouteInfoRefId> <Status>Continue</Status> </RouteStatus> <Odometer Unit="km">100000.0</Odometer> <Speedometer Unit="km">60</Speedometer> <Students> <Student> <StudentPersonalRefId>F3B35B359D75101A8C3D00AA001A0000</StudentPersonalRefId> <Status>Entered</Status> </Student> <Student> <StudentPersonalRefId>A7E35B359D75101A8C3D00BB211A0000</StudentPersonalRefId> <Status>Entered</Status> </Student> <Student> <StudentPersonalRefId>A9D35B359D75101A8C3D00AA001A9999</StudentPersonalRefId> <Status>Entered</Status> </Student> </Students> </BusPositionInfo>
Example 6.16.3-1: BusPositionInfo

### 6.16.4 BusRouteDetail

This object contains the schedule for the bus route.

SIF_Events are reported for this object.

Figure 6.16.4-1: BusRouteDetail

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusRouteDetail |  | This object contains the schedule for the bus route. |
@ | RefId | M | GUID that identifies this object. | RefIdType
@ | BusRouteInfoRefId | M | GUID that identifies the bus route. | IdRefType
| BusStopInfoRefId | M | GUID that identifies a bus stop on the route. | IdRefType
| ArrivalTime | M | The time that the bus associated with this route will stop at this bus stop. | xs:time
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.4-1: BusRouteDetail
<BusRouteDetail RefId="D3E34B359D75101A8C3D00AA001A1652" BusRouteInfoRefId="C2F23F450B86234B9B3D00AA001A1652"> <BusStopInfoRefId>B7A34E561C97345C0A4E11BB112B2753</BusStopInfoRefId> <ArrivalTime>15:39:00-08:00</ArrivalTime> </BusRouteDetail>
Example 6.16.4-1: BusRouteDetail

### 6.16.5 BusRouteInfo

This object contains all of the information about a bus route.

SIF_Events are reported for this object.

Figure 6.16.5-1: BusRouteInfo

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusRouteInfo |  | This object contains all of the information about a bus route. |
@ | RefId | M | GUID that identifies this bus route. | RefIdType
| BusInfoRefId | M | GUID that identifies the bus that is associated with this route. | IdRefType
| RouteNumber | M | A unique identifier for the route. It may contain any printable ASCII character. F or instance, you may have route 16AM in the morning and a 16PM in the afternoon. | xs:normalizedString
| RouteType | M | The type of route. | values: Inbound Outbound
| MaximumLoad | O | The maximum number of students who are on the bus at any point along this route. | xs:unsignedInt
| Description | O | Short explanation of the route. It may be used to designate an area, or used to color-code bus routes (the "orange" route). | xs:string
| Name | O | Name of the driver who drives this route. | Name
| RouteDurationLoaded | O | Refers to the amount of time that at least one student is riding the bus. | xs:duration
| RouteDurationTotal | O | Includes time when no student is on the bus, including time driving to and from the garage, etc. | xs:duration
| RouteDistanceLoaded | O | Refers to the distance the bus drives when at least one student is riding the bus. | xs:decimal
@ | Unit | M | Distance unit used. | values: km kilometers m miles
| RouteDistanceTotal | O | Includes the total distance driven for this route including to and from garage. | xs:decimal
@ | Unit | M | Distance unit used. | values: km kilometers m miles
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.5-1: BusRouteInfo
<BusRouteInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <BusInfoRefId>A2E35B359D75101A8C3D00AA001A0000</BusInfoRefId> <RouteNumber>16AM</RouteNumber> <RouteType>Inbound</RouteType> <MaximumLoad>40</MaximumLoad> <Description>1st Transfer Bus</Description> <Name Type="02"> <LastName>Smith</LastName> <FirstName>Jon</FirstName> </Name> <RouteDurationLoaded>PT16M45S</RouteDurationLoaded> <RouteDurationTotal>PT28M00S</RouteDurationTotal> <RouteDistanceLoaded Unit="m">5.23</RouteDistanceLoaded> <RouteDistanceTotal Unit="m">9.9</RouteDistanceTotal> </BusRouteInfo>
Example 6.16.5-1: BusRouteInfo

### 6.16.6 BusStopInfo

This object contains information about a bus stop.

SIF_Events are reported for this object.

Figure 6.16.6-1: BusStopInfo

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| BusStopInfo |  | This object contains information about a bus stop. |
@ | RefId | M | GUID that identifies this location. | RefIdType
| Description | M | An explanation of this location. | xs:string
| GridLocation | O | The location of the bus stop. | GridLocation
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.6-1: BusStopInfo
<BusStopInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <Description>Elm St @ Pine Ave</Description> <GridLocation> <Latitude>41.850000</Latitude> <Longitude>-87.650000</Longitude> </GridLocation> </BusStopInfo>
Example 6.16.6-1: BusStopInfo

### 6.16.7 StudentTransportInfo

This object contains transportation information about a student. Students should have at least two StudentTransportInfo objects associated with them: one for inbound information (getting to school) and one for outbound information (leaving school). If their transportation changes based on the day of the week, then a student will have more than two StudentTransportInfo objects.

SIF_Events are reported for this object.

Figure 6.16.7-1: StudentTransportInfo

| Element/@Attribute | Char | Description | Type
--- | --- | --- | --- | ---
| StudentTransportInfo |  | This object contains transportation information about a student. Students should have at least two StudentTransportInfo objects associated with them: one for inbound information (getting to school) and one for outbound information (leaving school). If their transportation changes based on the day of the week, then a student will have more than two StudentTransportInfo objects. |
@ | RefId | M | GUID that identifies this object. | RefIdType
@ | StudentPersonalRefId | M | GUID that identifies the student that this object refers to. | IdRefType
@ | Type | M | The direction of transportation that this object refers to. | values: Inbound Outbound
@ | DayOfWeek | M | This attribute indicates the day(s) of the week to which this object refers. | xs:token
xs:pattern | (Mo)?(Tu)?(We)?(Th)?(Fr)?(Sa)?(Su)?
@ | SchoolInfoRefId | M | GUID referring to the school that the student attends on these day(s) of the week. | IdRefType
| Eligibility | O | Eligibility status of student for district transportation for this trip. | values: Bus Walk BusHazard BusOutOfAttendance ParentPay Unknown
| HomeBusRouteDetail | O | GUID referring to a BusRouteDetail object that identifies the origin bus stop for an inbound route or the destination bus stop for an outbound route. If the HomeBusRouteDetail element does not exist, then the student does not ride a bus to/from school. | IdRefType
@ | SIF_RefObject | M |  | values: BusRouteDetail
| TransferPoints | O |  | List
| TransferPoints/TransferPoint | OR | There should be one TransferPoint element for each intermediate point on a trip. The "embark" and "disembark" bus stops for a single transfer point must be at the same location. To order multiple TransferPoint elements, use the Time element of the BusStopInfo objects referenced by the attributes. |
| TransferPoints/TransferPoint/ EmbarkBusRouteDetail | M | GUID that identifies the bus stop/route where the student gets on the bus. | IdRefType
@ | SIF_RefObject | M |  | values: BusRouteDetail
| TransferPoints/TransferPoint/ DisembarkBusRouteDetail | M | GUID that identifies the bus stop/route where the student gets off the bus. | IdRefType
@ | SIF_RefObject | M |  | values: BusRouteDetail
| SchoolBusRouteDetail | O | GUID referring to a BusRouteDetail object that identifies the origin bus stop for an outbound route or the destination bus stop for an inbound route. If the SchoolBusRouteDetail does not exist, then the student does not ride a bus to/from school. | IdRefType
@ | SIF_RefObject | M |  | values: BusRouteDetail
| SIF_Metadata | O |  | SIF_Metadata
| SIF_ExtendedElements | O |  | SIF_ExtendedElements

Table 6.16.7-1: StudentTransportInfo
<StudentTransportInfo RefId="D3E34B359D75101A8C3D00AA001A1652" StudentPersonalRefId="C2F23F450B86234B9B3D00AA001A1652" Type="Inbound" DayOfWeek="MoWeFr" SchoolInfoRefId="B7A34E561C97345C0A4E11BB112B2753"> <Eligibility>Bus</Eligibility> <HomeBusRouteDetail SIF_RefObject="BusRouteDetail">A3B7564E971C5C344E0ABB11EE272B53</HomeBusRouteDetail> <SchoolBusRouteDetail SIF_RefObject="BusRouteDetail">7B3AE465C17943C5A0E411BB11B27235</SchoolBusRouteDetail> </StudentTransportInfo>
Example 6.16.7-1: StudentTransportInfo