We received this e-mail from the sunlight foundation. It appears they will be overhauling their API. This will likely require an update to the scripts and extensions I've used to populate our wiki.
Ilan -------- Original Message -------- Subject: Sunlight API v2 migration (draft 2) Date: Mon, 23 Jun 2008 18:07:16 -0400 From: James Turk <> <http://sunlightwiki.sunlightlabs.org/index.php/API_v2_migration#places_namespace> This is a portion of the transition document planned for the major overhaul of the Sunlight Labs API. The goal here is to reduce the number of overall methods to make the API simpler to use and to maintain. the two legislators.* methods have all the functionality of the old people.* methods (with the exception of getHCard which is extremely infrequently used) The functionality of the states.* methods and the places.* methods that don't deal with districts are likely being deprecated with no replacement as the focus of the API should be on political entities like districts and entities. Comments/Questions/"Oh No! You can't remove that we NEED it" are welcome ----------- New methods: legislators.get - get exactly 1 legislator (returns an error if query would return multiple) legislators.getList - get 0 or more legislators that match any number of constraints districts.getDistrictsFromZip - same as places.getDistrictsFromZip version of this method but with more up to date data districts.getZipsFromDistrict - inverse of getDistrictsFromZip districts.getDistrictFromLatLong - same as places.getDistrictFromLatLong **more that don't resemble anything in API v1** * *people.convertId* - use legislators.get * *people.getDataItem* - use legislators.get * *people.getDataCondition* - replaced by legislators.getList * *people.getPersonInfo* - replaced by legislators.get * *people.getHCard* - no replacement planned * *people.reps.getRepFromDistrict* - use /legislators.get?state=XX&district=YY/ * *people.sens.getSensFromState* - use /legislators.get?state=XX&title=Senator/ *states.getAbbreviationFromName* and* states.getNameFromAbbreviation* have been removed, using a webservice for such a lookup is not recommended as this data does not change * *places.getCityStateFromZip* - no replacement * *places.getDistrictFromAddress* - use google/yahoo/geocoder.us <http://geocoder.us> to get lat/long and then call districts.getDistrictFromLatLong * *places.getDistrictsFromZip* - districts.getDistrictsFromZip * *places.getDistrictFromLatLong* - districts.getDistrictFromLatLong * *places.109th.getDistrictsFromZip5* - no replacement * *places.getStateFromZip* - no replacement * *places.getLatLongFromZip* - no replacement * *places.getLatLongsFromCityState* - no replacement * *places.getTimezoneFromCityState* - no replacement * *places.getZipsFromCityState* - no replacement _______________________________________________ Bytesfree-discuss mailing list Bytesfree-discuss@bytesfree.org http://www.bytesfree.org/mailman/listinfo/bytesfree-discuss
