Bongo Data

All of the data for Bongo is copyrighted by the University of Iowa, the City of Iowa City and/or the City of Coralville and is not permitted to be used in a commercial application.

API Endpoints

/routes

Parameters

None

Returns

Array of routes with the following data:

Name Type Description
id Number Unique identifier for the route
name String Human readable name for the route
shortname String Short name for route, used for URLs
color String Hex code for the color for the route
agency String Agency short name, used for URLs
agencyname String Human readable name for the agency
/routes/{routeid}

Parameter

Name Type Description
routeid Number Unique identifier for the route

Returns

Route object with the following data:

Name Type Description
id Number Unique identifier for the route
name String Human readable name for the route
shortname String Short name for route, used for URLs
color String Hex code for the color for the route
agency String Agency short name, used for URLs
agencyname String Human readable name for the agency
stops Array Collection of all stops for the route. Each stop has an id, name, lat and lon value
maxlat Number Maximum latitude for the route
minlat Number Minimum latitude for the route
maxlon Number Maximum longitude for the route
minlat Number Minimum longitude for the route
paths Array Collection of all paths for the route. Each path has a array of points which have a lat and lon value
/stops

Parameters

None

Returns

Array of stops with the following data:

Name Type Description
id Number Unique identifier for the stop
name String Human readable name for the stop
lat Number Latitude for the stop
lon Number Longitude for the stop
Stop numbers are organized in the following way:
1-999 - Shared stop across more than one agency
1000-3999 - Cambus stop
4000-6999 - Coralville stop
7000-9999 - Iowa City stop
/stops/{stopid}

Parameter

Name Type Description
stopid Number Unique identifier for the stop

Returns

Stop object with the following data:

Name Type Description
id Number Unique identifier for the stop
name String Human readable name for the stop
lat Number Latitude for the stop
lon Number Longitude for the stop
messages Array Collection of all messages for routes that service this stop. Each message has an id, name, text, start and end value
Stop numbers are organized in the following way:
1-999 - Shared stop across more than one agency
1000-3999 - Cambus stop
4000-6999 - Coralville stop
7000-9999 - Iowa City stop
/buses/{routeid}

Parameter

Name Type Description
routeid Number Unique identifier for the route

Returns

Array of buses with the following data:

Name Type Description
id Number Unique identifier for the bus
lat Number Latitude for the stop
lon Number Longitude for the stop
heading Number Bus heading in degrees
/predictions/{stopid}

Parameter

Name Type Description
stopid Number Unique identifier for the stop

Returns

Array of predictions with the following data:

Name Type Description
routeid Number Unique identifier for the route
name String Human readable name for the route
shortname String Short name for route, used for URLs
busid Number Unique identifier for the bus
busnumber String Bus label on the back of the bus
seconds Number Prediction in seconds until arrival
minutes Number Prediction in minutes until arrival, rounded up from seconds
agency String Agency short name, used for URLs
agencyname String Human readable name for the agency