For Developers
Routes Overview
A route is a sequence of stops that a vehicle will visit in a particular order. Routes are associated with a vehicle and a driver. Routes are also associated with a set of stops. The stops are ordered in the route. The order of the stops in the route is important. The order of the stops in the route determines the order in which the stops are visited by the vehicle.
Properties
Property | Type | Description |
---|---|---|
id | string | The UUID for the route. $filter operators: equals in not in |
created_date | Date | When the route was first seen by Edlink. |
updated_date | Date | When the route was last changed in Edlink. $filter operators: equals gt lt gte lte |
properties | object | Non-standard properties that may be of interest to the developer. |
code | string | The unique code assigned to the route. |
description | string | A description of the route. |
state | RouteState[] | The state of the route. |
mileage | number | The total mileage of the route. |
flags | RouteFlag[] | The flags for the route. All, some, or none of the possible flags may be included. |
route_stops | RouteStop[] | The sequence of stops that a vehicle will visit in a particular order. |
identifiers | Identifier[] | Additional IDs associated with the object. |
stop_ids | string[] | An array of UUIDs of the associated Stops. |
vehicle_id | string | The UUID of the associated Vehicle. |
driver_id | string | The UUID of the associated Driver. |
JSON Example
{
"id": "00000000-0000-0000-0000-000000000000",
"created_date": "2021-07-13T17:45:27.570Z",
"updated_date": "2021-07-13T17:45:27.570Z",
"properties": {},
"code": "ROUTE001",
"description": "A daily route for school transportation.",
"state": "active",
"mileage": 20,
"mileage": 4,
"flags": [],
"route_stops": [
{
"stop_id": "22222222-2222-2222-2222-222222222222",
"arrival_time": "07:00",
"departure_time": "07:10"
},
{
"stop_id": "33333333-3333-3333-3333-333333333333",
"arrival_time": "07:20",
"departure_time": "07:30"
},
{
"stop_id": "44444444-4444-4444-4444-444444444444",
"arrival_time": "07:40",
"departure_time": "07:50"
},
{
"stop_id": "55555555-5555-5555-5555-555555555555",
"arrival_time": "08:00",
"departure_time": "08:10"
}
],
"stop_ids": ["22222222-2222-2222-2222-222222222222", "33333333-3333-3333-3333-333333333333", "44444444-4444-4444-4444-444444444444", "55555555-5555-5555-5555-555555555555"],
"vehicle_id": "00000000-0000-0000-0000-000000000000",
"driver_id": "00000000-0000-0000-0000-000000000000"
}