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

PropertyTypeDescription
idstringThe UUID for the route.
$filter operators: equals in not in
created_dateDateWhen the route was first seen by Edlink.
updated_dateDateWhen the route was last changed in Edlink.
$filter operators: equals gt lt gte lte
propertiesobjectNon-standard properties that may be of interest to the developer.
codestringThe unique code assigned to the route.
descriptionstringA description of the route.
stateRouteState[]The state of the route.
mileagenumberThe total mileage of the route.
flagsRouteFlag[]The flags for the route. All, some, or none of the possible flags may be included.
route_stopsRouteStop[]The sequence of stops that a vehicle will visit in a particular order.
identifiersIdentifier[]Additional IDs associated with the object.
stop_idsstring[]An array of UUIDs of the associated Stops.
vehicle_idstringThe UUID of the associated Vehicle.
driver_idstringThe 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"
}