#About 311# 311 systems are non-emergency civic issue trackers. Think potholes, water leaks, and graffitti, In this case 311 is not a phone number instead it is a technology that provides open channels of communication for issues that concern public space and public services.
This page will attempt to document the API the City of Asheville uses so we can create "civic hacks" on the 311 data. Think info graphics, predictive anyalsis, and maps.
join us for a series of hack nights and talks to explore the City of Asheville 311 data. see our meetup at http://www.meetup.com/Code-for-Asheville/
#API Documention#
###Getting Started###
- The Offical documentation is here tps://www.publicstuff.com/developers
- Request an API key from https://www.publicstuff.com/developers/api
###The Offical API documetentation is here### https://www.publicstuff.com/developers/api
for us the main things are as follows:
- Asheville City client_id is 819
- Asheville City city ID or space_id is 3737
- you also will need an API key, request one from https://www.publicstuff.com/developers/api
###Sample API Calls### For all samples the return data type, return_type, is set to json for the samples (valid types are xml, json, or jsonp) All samples require a api key that you will need to get from https://www.publicstuff.com/developers/api you will have to put your api key in place of this [your api key] in the examples. This is not the full list of options but can hopefully get us started, the full documentation is @ https://www.publicstuff.com/developers/api
###city_view### Get information about Asheville
https://www.publicstuff.com/api/2.0/city_view?return_type=json&space_id=3737&api_key= [your api key]
###request_types### Get all valid requests types for the City of Asheville. Request types are issues like water leaks, potholes, graffiti, and etc. Note the request type for parks - 11345 for next examples.
https://www.publicstuff.com/api/2.0/requesttypes_list?client_id=819&api_key= [your api key]
###requests_list###
Get the first 100 requests for service, to report problems a city park in this cae withn 100 meters around downtown.
Note the lat(latitude),lon(longitude),limit(number of records to return), and nearby(distance) values.
###request_view### From the returned JSON you might want to see the full request for service for the an issue, using issue #98168 as example.
https://www.publicstuff.com/api/2.0/request_view?return_type=json&request_id=98168&api_key= [your api key]
###comments_list###
For each reuquest for service there is likely comments related to resloving the issue.
In this case the citizen reporting and the City Employee commuicate via the app until the issue is resolved.
For issue #98168 here are 6 comments.
https://www.publicstuff.com/api/2.0/comments_list?return_type=json&request_id=98168&api_key= [your api key]