Developer

Description
This API returns geographies by name of a specific geography type within a state.

Please note: TimeSeries Fall2010 and Dec2010 are no longer available. Use /jun2011/

Why We Provide It
We are providing this API to increase the value of the transparency of the National Broadband Map. With this API you can get back the geographies by name within a state.

Review Data Dictionary

JSON   XML

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

API Call
{API Base}/geography/state/{stateFips}/{geographyType}/name/{geographyName}?maxresults={maxResults}&all={all}&format={format}&callback={functionName}

Sample Call
http://www.broadbandmap.gov/broadbandmap/geography/state/17/county/name/mar?format=json

Required Parameters
stateFips:
specify the state fips to search for the specific geography types.

geographyType:
specify either one of the following geography type: county, censusplace, msa, usf, statesenate, statehouse, congdistrict, tribalnation.

geographyName:
specify the geography name with atleast 3 leading characters.

maxResults:
specify the maximum results to be returned. defaulted 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":3,
 "message":[
  
 ],
 "Results":[
  {
   "geographyId":"17121",
   "geographyName":"Marion",
   "stateFips":"17",
   "stateName":"Illinois",
   "stateAbbreviation":"IL"
  },
  {
   "geographyId":"17123",
   "geographyName":"Marshall",
   "stateFips":"17",
   "stateName":"Illinois",
   "stateAbbreviation":"IL"
  }
 ]
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="2">
  <Results>
    <geographyId>17121</geographyId>
    <geographyName>Marion</geographyName>
    <stateFips>17</stateFips>
    <stateName>Illinois</stateName>
    <stateAbbreviation>IL</stateAbbreviation>
 </Results>
 <Results>
   <geographyId>17123</geographyId>
   <geographyName>Marshall</geographyName>
   <stateFips>17</stateFips>
   <stateName>Illinois</stateName>
   <stateAbbreviation>IL</stateAbbreviation>
</Results>
</Response>