Real time service providing car park information and space data to developers via a REST API.

The API endpoints that are listed on this page provide real time car park information and parking space data. The first endpoint which is /api/parking/:city provides a list of car parks that are supported within a given city. At present, the only city that is supported is Southampton. The second endpoint provides extended information and data about a single car park. Both of these endpoints will return a JSON object as detailed in the 'Response' section.

 

Request
GET https://dor.ky/api/parking/:woeid

This API endpoint takes a :woeid of a city as the last path of the URL and returns a JSON object containing an array called 'locations'. This array contains the internal ID and name for each car park within the requested :woeid that there is data for, as well as an image if possible. You can then use the returned ID to lookup extended car park information and space data as shown below. I'd advise that you cache this data within your own system as it doesn't changed too often. The only active :woeid at the moment is 24875484 which is the county of Southampton, UK.

Response
application/json

 

Request
GET https://dor.ky/api/parking/:city/:id

With the ID provided in the GET /api/parking/:city endpoint, you now have car park IDs to work with. Using the car park ID of your choice, you can get extended information and space data by calling this endpoint. This will return you the current status, free spaces now, free spaces in 30 minutes and free spaces in 60 minutes. The 'status' element can also detail whether are car park is open or closed.

Response
application/json

Pushing to the Future

Now it is up to developers to create systems to better use this data. I've created a pilot system that you can see live on this site which graphs the current status of each car park along with space data. It also provides a consumer orientated system for people to call in for accurate parking space information via their telephone. If you decide to use this data in any way, I'd love to hear about it.