DeveloperAPI » Geography Lookup API - By Geography Type And Geography Name
Description
This API returns geographies by name of a specific geography type.
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 users can search for any US Census geography type and name and get back the list of those geographies with their Census codes.
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/geography/{geographyType}/name/{geographyName}?maxresults={maxResults}&all={all}&format={format}&callback={functionName}
Sample Call
http://www.broadbandmap.gov/broadbandmap/geography/censusplace/name/sei?format=json
Required Parameters
geographyType:
specify either one of the following geography type: state, county, censusplace, msa, usf, statesenate, statehouse, congdistrict, tribalnation
geographyName:
specify the geography name with at least 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
{ "status":"OK", "responseTime":3, "message":[ ], "Results":[ { "geographyId":"0869040", "geographyName":"Seibert", "stateFips":"08" }, { "geographyId":"4066250", "geographyName":"Seiling", "stateFips":"40" } ] }
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response status="OK" responseTime="2"> <Results> <geographyId>0869040</geographyId> <geographyName>Seibert</geographyName> <stateFips>08</stateFips> </Results> <Results> <geographyId>4066250</geographyId> <geographyName>Seiling</geographyName> <stateFips>40</stateFips> </Results> </Response>