For Developers

Routes Overview

A Route represents an ordered list of stops that a specific vehicle, operated by a specific driver, will visit. Each route is tied to exactly one vehicle and one driver, and contains a defined sequence of stops. The order of these stops is intentional and dictates the exact visitation order followed 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,
    "flags": [],
    "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",
    "rider_ids": ["66666666-6666-6666-6666-666666666666", "77777777-7777-7777-7777-777777777777"],
    "identifiers": [
        {
            "type": "sis_id",
            "value": "EXT-ROUTE-12345"
        }
    ],
}