Developer

API » Geography Lookup API - By Geography Type Within A State


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

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 within a state and get back the list of those geographies with their Census codes.

Review Data Dictionary

JSON   XML

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

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

Sample Call
https://www.broadbandmap.gov/broadbandmap/geography/state/01/msa?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.

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":4,
 "message":[
  
 ],
 "Results":[
  {
   "geographyId":"11500",
   "geographyName":"Anniston-Oxford, AL Metro Area"
  },
  {
   "geographyId":"12220",
   "geographyName":"Auburn-Opelika, AL Metro Area"
  },
  {
   "geographyId":"13820",
   "geographyName":"Birmingham-Hoover, AL Metro Area"
  },
  {
   "geographyId":"17980",
   "geographyName":"Columbus, GA-AL Metro Area"
  },
  {
   "geographyId":"19460",
   "geographyName":"Decatur, AL Metro Area"
  },
  {
   "geographyId":"20020",
   "geographyName":"Dothan, AL Metro Area"
  },
  {
   "geographyId":"22520",
   "geographyName":"Florence-Muscle Shoals, AL Metro Area"
  },
  {
   "geographyId":"23460",
   "geographyName":"Gadsden, AL Metro Area"
  },
  {
   "geographyId":"26620",
   "geographyName":"Huntsville, AL Metro Area"
  },
  {
   "geographyId":"33660",
   "geographyName":"Mobile, AL Metro Area"
  },
  {
   "geographyId":"33860",
   "geographyName":"Montgomery, AL Metro Area"
  },
  {
   "geographyId":"46220",
   "geographyName":"Tuscaloosa, AL Metro Area"
  }
 ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="5">
  <Results>
    <geographyId>11500</geographyId>
    <geographyName>Anniston-Oxford, AL Metro Area</geographyName>
 </Results>
 <Results>
   <geographyId>12220</geographyId>
   <geographyName>Auburn-Opelika, AL Metro Area</geographyName>
</Results>
<Results>
  <geographyId>13820</geographyId>
  <geographyName>Birmingham-Hoover, AL Metro Area</geographyName>
</Results>
<Results>
 <geographyId>17980</geographyId>
 <geographyName>Columbus, GA-AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>19460</geographyId>
<geographyName>Decatur, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>20020</geographyId>
<geographyName>Dothan, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>22520</geographyId>
<geographyName>Florence-Muscle Shoals, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>23460</geographyId>
<geographyName>Gadsden, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>26620</geographyId>
<geographyName>Huntsville, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>33660</geographyId>
<geographyName>Mobile, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>33860</geographyId>
<geographyName>Montgomery, AL Metro Area</geographyName>
</Results>
<Results>
<geographyId>46220</geographyId>
<geographyName>Tuscaloosa, AL Metro Area</geographyName>
</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.