Developer

API » Census API - By Geography Name


Description
This API finds all the geographies specified by a geography name (e.g., Washington) of a specific geography type (e.g., congressional district) within the entire United States.

Latest data version released dec2012. Previous data versions include jun2011, dec2011, jun2012.

Why We Provide It
We are providing this API to increase the value of the transparency of the National Broadband Map. Just about every major dataset in the US Federal Government uses some form of Census geography. With this API you can retrieve all the associated census geographies by providing the name of the higher geography and the type you want back. 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.

Review Data Dictionary

JSON   XML

API Base
http://www.broadbandmap.gov/broadbandmap/

API Call
{API Base}/census/{geographyType}/{geographyName}?maxresults={maxResults}&all={all}&format={format}&callback={functionName}

Sample Call
http://www.broadbandmap.gov/broadbandmap/census/county/fai?format=json

Required Parameters
geographyType:
specify one of the following geography types: state, county, tract, block, congdistrict, statehouse, statesenate, censusplace, msa

geographyName:
specify the geography name with at least 3 leading characters.

maxResults:
specify the maximum results to be returned - defaults to 100.

all:
if true returns the complete set of results.

Optional Parameters
format:
XML, JSON, JSONP (XML is default)

callback:
JSONP callback function name

Response

JSON   XML

{
 "status":"OK",
 "responseTime":17,
 "message":[
  
 ],
 "Results":{
  "county":[
   {
    "geographyType":"COUNTY2010",
    "stateFips":"51",
    "fips":"51600",
    "name":"Fairfax"
   },
   {
    "geographyType":"COUNTY2010",
    "stateFips":"02",
    "fips":"02090",
    "name":"Fairbanks North Star"
   },
   {
    "geographyType":"COUNTY2010",
    "stateFips":"39",
    "fips":"39045",
    "name":"Fairfield"
   },
   {
    "geographyType":"COUNTY2010",
    "stateFips":"09",
    "fips":"09001",
    "name":"Fairfield"
   },
   {
    "geographyType":"COUNTY2010",
    "stateFips":"51",
    "fips":"51059",
    "name":"Fairfax"
   },
   {
    "geographyType":"COUNTY2010",
    "stateFips":"45",
    "fips":"45039",
    "name":"Fairfield"
   }
  ]
 }
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="26">
  <Results>
    <county>
      <geographyType>COUNTY2010</geographyType>
      <stateFips>51</stateFips>
      <fips>51600</fips>
      <name>Fairfax</name>
   </county>
   <county>
     <geographyType>COUNTY2010</geographyType>
     <stateFips>02</stateFips>
     <fips>02090</fips>
     <name>Fairbanks North Star</name>
  </county>
  <county>
    <geographyType>COUNTY2010</geographyType>
    <stateFips>39</stateFips>
    <fips>39045</fips>
    <name>Fairfield</name>
 </county>
 <county>
   <geographyType>COUNTY2010</geographyType>
   <stateFips>09</stateFips>
   <fips>09001</fips>
   <name>Fairfield</name>
</county>
<county>
  <geographyType>COUNTY2010</geographyType>
  <stateFips>51</stateFips>
  <fips>51059</fips>
  <name>Fairfax</name>
</county>
<county>
 <geographyType>COUNTY2010</geographyType>
 <stateFips>45</stateFips>
 <fips>45039</fips>
 <name>Fairfield</name>
</county>
</Results>
</Response>




Back to Top

You are automatically leaving the National Broadband Map site press escape key to cancel

You're leaving the National Broadband Map Website

You are now leaving the National Broadband Map web site, and will be automatically forwarded to the following site:

%url%

This link is provided for informational purposes only. We do not endorse any other product or service, and are not responsible for the content of other websites, including their accuracy, completeness, or timeliness.