City of Asheville 311 api documentation
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
LICENSE
README.md

README.md

City of Asheville 311 api documentation

#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 API documetentation is here### https://www.publicstuff.com/developers/api

for us the main things are as follows:

###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.

http://www.publicstuff.com/api/2.0/requests_list?return_type=json&limit=100&lat=35.62336&request_type_id=11345&lon=-82.561531&nearby=250&api_key= [your api key]

###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]