Description
This API returns the US Census Bureau Census Block number (aka the 15 character FIPS Code) given a passed Latitude and Longitude. The API also returns the US State and County name associated with the Block.
Why We Provide It
Just about every major dataset in the US Federal Government uses some form of Census geography. The lowest level of that geography is the Census Block. This geography is highly nested, such that removing coded values from the right hand site aggregates to the next highest geography (e.g. from block to tract, and from tract to County). Providing this search allows developers to build applications which foster connectivity from their individual location to the full array of federal databases based on census geography.
Web Application Description Language (WADL)
Endpoint - http://data.fcc.gov/api/block/application.wadl
WADL Content
<doc jersey:generatedBy="Jersey: 1.0.2 02/11/2009 07:45 PM"/>
<resources base="http://data.fcc.gov:80/api/block/">
<resource path="">
<resource path="find">
<method name="GET" id="findBlockByCoordinates">
<request>
<param type="xs:double" style="query" name="latitude"/>
<param type="xs:double" style="query" name="longitude"/>
<param type="xs:string" style="query" name="format"/>
<param type="xs:string" style="query" name="callback"/>
</request>
<response>
<representation mediaType="application/x-javascript"/>
<representation mediaType="application/json"/>
<representation mediaType="application/xml"/>
</response>
</method>
</resource>
</resource>
<resource path="2000/find">
<method name="GET" id="findBlock2000ByCoordinates">
<request>
<param type="xs:double" style="query" name="latitude"/>
<param type="xs:double" style="query" name="longitude"/>
<param type="xs:string" style="query" name="format"/>
<param type="xs:string" style="query" name="callback"/>
</request>
<response>
<representation mediaType="application/x-javascript"/>
<representation mediaType="application/json"/>
<representation mediaType="application/xml"/>
</response>
</method>
</resource>
</resource>
</resources>
</application>
Census Block Method Call
- latitude – Latitude of the point
- longitude – Longitude of the point
- censusYear- Presently 2000, 2009, 2010 census years are supported(defaulted to 2010 if census year is not specified)
- format (optional) – Default is xml. Valid values are: xml, json, jsonp
- callback (optional) – jsonp callback function name
- response
In this version, we added the possibility to search for Census Bureau block information for the year 2000, using the following URL:
http://data.fcc.gov/api/block/2000/find?latitude=40.0&longitude=-85
- JSONP
- callback({"@executionTime":"0.045","@status":"OK","Block":{"@FIPS":"510339905003000"},"County":{"@name":"Caroline","@FIPS":"51033"},"State":{"@name":"Virginia","@code":"VA","@FIPS":"51"}})
- JSON
- {
"executionTime": "0.045",
"status": "OK",
"Block": {"FIPS":"510339905003000"},
"County": {"name":"Caroline","FIPS":"51033"},
"State": {"name":"Virginia","code":"VA","FIPS":"51"}
} - XML
- <Response executionTime="0.045" status="OK">
<Block FIPS="510339905003000"/>
<County name="Caroline" FIPS="51033"/>
<State name="Virginia" code="VA" FIPS="51"/>
</Response> - Error Response
In case there is any exception on the server side it is caught and the http status code 500 is returned. (INTERNAL SERVER ERROR). The status description contains the detailed reason for the failure.
Previous Versions
