opendata

Joomla Templates and Joomla Extensions by JoomlaVision.Com

follow us

Wednesday, 01 June 2011 10:31

Service Provider API (Reentry Focus)

Rate this item
(0 votes)

As part of our commitment to Open Data and to encourage efficiency in our partner agencies and nonprofits we are making our rich service provider database available as a data feed for use in whatever system, application or listing service you desire. If you are a coder, developer or hacker this is for you. If you're not technically inclined then we'd suggest you head on back to our Data Portal for more people friendly data. Or you can take a look at our web site that uses this data at www.alamedareentryservices.org.

 

The service provider directory contains listings for over 400 service providers, not just those providing specific reentry services but almost all providers in the county. This dataset was collated and quality checked over several months in 2010 and is a very comprehensive listing of social service providers in our county with rich details including service eligibility, opening hours, accessibility and more. Based on the type of service provided, the organizations are organized into general categories and then further divided into subcategories. To gain access to the  locations, the client needs to provide the category and subcategory names. Please note service provider locations may contain duplicates since most locations provide multiple services across several categories/subcategories.

*Red Options are Required

Default return format is xml


Function Call:Get service categories
BASE URL: http://rest.infoalamedacounty.org/index.php/api/reentry/servicegroup
Options:
• format-[xml,json,serialize,php,html,csv]
Example Return http://rest.infoalamedacounty.org/index.php/api/reentry/servicegroup

<xml>
<item>
<categoryID>1</categoryID>
<name>Housing</name>
</item>
<item>
<categoryID>2</categoryID>
<name>Legal</name>
</item>

////////////////////////////////////////////////////////////////////////////////////////////////////////////
Function Call: Get service subcategories
Base URL: http://rest.infoalamedacounty.org/index.php/api/reentry/services
Options:
• format-[xml,json,serialize,php,html,csv]
categoryID:Int
Example Return http://rest.infoalamedacounty.org/index.php/api/reentry/services/categoryID/1

<xml>
<item>
<name>Temporary/ Transitional Housing</name>
<definition>
Bridges the gap between emergency shelter and permanent affordable housing.
</definition>
</item>
<item>
<name>Emergency Shelter</name>
<definition>
Temporary housing on a night-by-night or week-by-week basis.
</definition>
</item>

////////////////////////////////////////////////////////////////////////////////////////////////////////////
Function Call: Get locations of service providers
Base URL: http://rest.infoalamedacounty.org/index.php/api/reentry/locations
Options:
• format-[xml,json,serialize,php,html,csv]
service:String
• miles:int- buffer distance from a point to gather services
• latitude:double- the latitude of the point to buffer
• longitude:double -the longitude of the point to buffer
Example Return:
http://rest.infoalamedacounty.org/index.php/api/reentry/locations/service/Emergency Shelter
<xml>
<item>
<name>Society of St. Vincent de Paul</name>
<address>675 23rd Street</address>
<city>Oakland</city>
<zip>94612</zip>
<phone>(510) 877-9218</phone>
<email/>
<latitude>37.813634</latitude>
<longitude>-122.273776</longitude>
<distance>13.700327155719</distance>
</item>
<item>
<name>Building Futures for Women and Children</name>
<address>1395 Bancroft Avenue</address>
<city>San Leandro</city>
<zip>94577</zip>
<phone>510- 357-0205</phone>
<email/>
<latitude>37.726391</latitude>
<longitude>-122.147672</longitude>
<distance>4.5485173567126</distance>
</item>

All we ask in return is that you tell us how you are using the API (so we can get funding to keep it going) and your ideas on how we can improve or expand the API.

Please refer to the attached document to get started.

Read 2996 times Last modified on Monday, 06 August 2012 13:38
More in this category: Oakland Crime Reports API »
Login to post comments

Funded by:


akonadi ESRI grants
sff