Bongo Developer API

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.

One of the primary reasons that Bongo is useful for the residents of the Iowa City metro area is that all three transit agencies participated in the system. Following that key covenant of Bongo, the Bongo API includes information for all three transit agencies together.

Support

A support community is located on Google+ at https://plus.google.com/communities/102129876377787257184.

API Keys

A key is required to use the API now. This is to help us keep track of what applications are using the API and have a way to communicate when changes are made. A link to the request form can be found on the Developer Community site.

Formats

The Bongo API can be retrieved in a number of different formats. These are XML, JSON and JSONP. The default format is XML, so if you do not pass a format parameter, you will receive XML back. To get JSON or JSONP, pass the format parameter in the URL. For example, if you wanted to get the route list in JSON, you would enter

http://api.ebongo.org/routelist?format=json&api_key=XXXX

Apps Using the API

Web

iOS

Android

Data

Route Listing

This will display a list of all routes in the Bongo system.

URI - http://api.ebongo.org/routelist?api_key=XXXX

Route Info

This will display information for a specific route. This takes two parameters, agency for the transit agency for the route and route for the route tag.

URI - http://api.ebongo.org/route?agency=XXXX&route=XXXX&api_key=XXXX

Stop Listing

This will display all stops in Bongo. Note, this may take some time to load due to the amount of information retrieved.

URI - http://api.ebongo.org/stoplist?api_key=XXXX

Stop Info

This will display information for a specific stop. This takes one parameter, stopid for stop number

URI - http://api.ebongo.org/stop?stopid=XXXX&api_key=XXXX

Predictions

This will display arrival predictions for a specific stop. This takes one parameter, stopid for stop number

URI - http://api.ebongo.org/prediction?stopid=XXXX&api_key=XXXX

Bus Locations

This will display location information for buses on a specific route. This takes two parameters, agency for the transit agency for the route and route for the route tag.

URI - http://api.ebongo.org/buslocation?agency=XXXX&route=XXXX&api_key=XXXX