DeveloperAPI » Provider Statistics API - Provider Within A Geography
Description
This API returns broadband summary data for a particular provider within Geography. The data includes demographics, states in which the provider is available, different technologies and broadband speeds reported in the particular area being searched for on a scale of 0 to 1.
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 now have access to provider statistics within the geography.
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/provider/{dataVersion}/stats/state/{stateId}/{censusMetric}/{geographyType}/{geographyId}/{holdingCompanyNumber}?format={format}&callback={functionName}
Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2011
{stateId}:
specify the state id in which the provider statistics needs to be retrieved. Use Geography lookup API by geography type (state) to retrieve the state ids.
{censusMetric}:
specify the census metric by which the data has to be aggregated. It can be only population as of now.
{geographyType}:
specify either one of the following geography type: county, censusplace, msa, usf, statesenate, statehouse, congdistrict, tribalnation.
{geographyId}:
specify the geography id in which the provider statistics needs to be retrieved. Use Geography lookup API by geography type to retrieve geography ids. For Tribal Nation, use 99 as stateId.
{holdingCompanyNumber}:
specify the holding company number of the provider using Provider by Geography API
Optional Parameters
format:
XML, JSON, JSONP (XML is default)
callback:
JSONP callback function name
{
"status":"OK",
"responseTime":5,
"message":[
],
"Results":{
"providerStatistics":{
"geographyName":"01",
"holdingCompanyName":"AT&T Inc.",
"landArea":2176.73220000,
"population":630280,
"populationDensity":164,
"households":290445,
"raceWhite":0.67480,
"raceBlack":0.27150,
"raceHispanic":0.02820,
"raceAsian":0.01450,
"raceNativeAmerican":0.01060,
"incomeBelowPoverty":0.18260,
"medianIncome":44587.01120,
"incomeLessThan25":0.34430,
"incomeBetween25to50":0.30680,
"incomeBetween50to100":0.27070,
"incomeBetween100to200":0.06220,
"incomeGreater200":0.01610,
"educationHighSchoolGraduate":0.78330,
"educationBachelorOrGreater":0.19330,
"ageUnder5":0.05320,
"ageBetween5to19":0.20410,
"ageBetween20to34":0.19550,
"ageBetween35to59":0.32470,
"ageGreaterThan60":0.22250,
"wirelineDownloadSpeedGreaterThan768k":0.64600,
"wirelineDownloadSpeedGreaterThan1500k":0.64600,
"wirelineDownloadSpeedGreaterThan3000k":0.64600,
"wirelineDownloadSpeedGreaterThan6000k":0.64600,
"wirelineDownloadSpeedGreaterThan10000k":0.61710,
"wirelineDownloadSpeedGreaterThan25000k":0.00000,
"wirelineDownloadSpeedGreaterThan50000k":0.00000,
"wirelineDownloadSpeedGreaterThan100000k":0.00000,
"wirelineDownloadSpeedGreaterThan1Gig":0.00000,
"wirelineUploadSpeedLessThan200k":0.00000,
"wirelineUploadSpeedGreaterThan200k":0.64600,
"wirelineUploadSpeedGreaterThan768k":0.64600,
"wirelineUploadSpeedGreaterThan1500k":0.61710,
"wirelineUploadSpeedGreaterThan3000k":0.61710,
"wirelineUploadSpeedGreaterThan6000k":0.00000,
"wirelineUploadSpeedGreaterThan10000k":0.00000,
"wirelineUploadSpeedGreaterThan25000k":0.00000,
"wirelineUploadSpeedGreaterThan50000k":0.00000,
"wirelineUploadSpeedGreaterThan100000k":0.00000,
"wirelineUploadSpeedGreaterThan1Gig":0.00000,
"wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.64600,
"wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.64600,
"wirelessDownloadSpeedGreaterThan768k":0.89540,
"wirelessDownloadSpeedGreaterThan1500k":0.89540,
"wirelessDownloadSpeedGreaterThan3000k":0.00000,
"wirelessDownloadSpeedGreaterThan6000k":0.00000,
"wirelessDownloadSpeedGreaterThan10000k":0.00000,
"wirelessDownloadSpeedGreaterThan25000k":0.00000,
"wirelessDownloadSpeedGreaterThan50000k":0.00000,
"wirelessDownloadSpeedGreaterThan100000k":0.00000,
"wirelessDownloadSpeedGreaterThan1Gig":0.00000,
"wirelessUploadSpeedLessThan200k":0.00000,
"wirelessUploadSpeedGreaterThan200k":0.89540,
"wirelessUploadSpeedGreaterThan768k":0.89540,
"wirelessUploadSpeedGreaterThan1500k":0.00000,
"wirelessUploadSpeedGreaterThan3000k":0.00000,
"wirelessUploadSpeedGreaterThan6000k":0.00000,
"wirelessUploadSpeedGreaterThan10000k":0.00000,
"wirelessUploadSpeedGreaterThan25000k":0.00000,
"wirelessUploadSpeedGreaterThan50000k":0.00000,
"wirelessUploadSpeedGreaterThan100000k":0.00000,
"wirelessUploadSpeedGreaterThan1Gig":0.00000,
"wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.89540,
"wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.00000,
"anyTechnology":0.90800,
"anyWireline":0.64600,
"dsl":0.64600,
"asymmetricDsl":0.64600,
"symmetricDsl":0.00000,
"copper":0.00000,
"cable":0.00000,
"cableDocsis":0.00000,
"cableOther":0.00000,
"opticalFiber":0.00000,
"powerline":0.00000,
"anyWireless":0.89540,
"satellite":0.00000,
"fixedWireless":0.00000,
"fixedWirelessUnlicensed":0.00000,
"fixedWirelessLicensed":0.00000,
"mobileWireless":0.89540,
"otherTechnology":0.00000,
"mostCommonDownloadSpeed":4.00000,
"mostCommonDownloadSpeedPercentage":0.90800,
"greatestDownloadSpeed":7.00000,
"greatestDownloadSpeedPercentage":0.61710,
"mostCommonUploadSpeed":3.00000,
"mostCommonUploadSpeedPercentage":0.90800,
"greatestUploadSpeed":5.00000,
"greatestUploadSpeedPercentage":0.61710
},
"statesServedByProvider":[
"01",
"02",
"04",
"05",
"06",
"08",
"09",
"10",
"11",
"12",
"13",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42",
"44",
"45",
"46",
"47",
"48",
"49",
"50",
"51",
"53",
"54",
"55",
"56",
"72",
"78"
]
}
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="5">
<Results>
<providerStatistics>
<geographyName>01</geographyName>
<holdingCompanyName>AT&T Inc.</holdingCompanyName>
<landArea>2176.73220000</landArea>
<population>630280</population>
<populationDensity>164</populationDensity>
<households>290445</households>
<raceWhite>0.67480</raceWhite>
<raceBlack>0.27150</raceBlack>
<raceHispanic>0.02820</raceHispanic>
<raceAsian>0.01450</raceAsian>
<raceNativeAmerican>0.01060</raceNativeAmerican>
<incomeBelowPoverty>0.18260</incomeBelowPoverty>
<medianIncome>44587.01120</medianIncome>
<incomeLessThan25>0.34430</incomeLessThan25>
<incomeBetween25to50>0.30680</incomeBetween25to50>
<incomeBetween50to100>0.27070</incomeBetween50to100>
<incomeBetween100to200>0.06220</incomeBetween100to200>
<incomeGreater200>0.01610</incomeGreater200>
<educationHighSchoolGraduate>0.78330</educationHighSchoolGraduate>
<educationBachelorOrGreater>0.19330</educationBachelorOrGreater>
<ageUnder5>0.05320</ageUnder5>
<ageBetween5to19>0.20410</ageBetween5to19>
<ageBetween20to34>0.19550</ageBetween20to34>
<ageBetween35to59>0.32470</ageBetween35to59>
<ageGreaterThan60>0.22250</ageGreaterThan60>
<wirelineDownloadSpeedGreaterThan768k>0.64600</wirelineDownloadSpeedGreaterThan768k>
<wirelineDownloadSpeedGreaterThan1500k>0.64600</wirelineDownloadSpeedGreaterThan1500k>
<wirelineDownloadSpeedGreaterThan3000k>0.64600</wirelineDownloadSpeedGreaterThan3000k>
<wirelineDownloadSpeedGreaterThan6000k>0.64600</wirelineDownloadSpeedGreaterThan6000k>
<wirelineDownloadSpeedGreaterThan10000k>0.61710</wirelineDownloadSpeedGreaterThan10000k>
<wirelineDownloadSpeedGreaterThan25000k>0.00000</wirelineDownloadSpeedGreaterThan25000k>
<wirelineDownloadSpeedGreaterThan50000k>0.00000</wirelineDownloadSpeedGreaterThan50000k>
<wirelineDownloadSpeedGreaterThan100000k>0.00000</wirelineDownloadSpeedGreaterThan100000k>
<wirelineDownloadSpeedGreaterThan1Gig>0.00000</wirelineDownloadSpeedGreaterThan1Gig>
<wirelineUploadSpeedLessThan200k>0.00000</wirelineUploadSpeedLessThan200k>
<wirelineUploadSpeedGreaterThan200k>0.64600</wirelineUploadSpeedGreaterThan200k>
<wirelineUploadSpeedGreaterThan768k>0.64600</wirelineUploadSpeedGreaterThan768k>
<wirelineUploadSpeedGreaterThan1500k>0.61710</wirelineUploadSpeedGreaterThan1500k>
<wirelineUploadSpeedGreaterThan3000k>0.61710</wirelineUploadSpeedGreaterThan3000k>
<wirelineUploadSpeedGreaterThan6000k>0.00000</wirelineUploadSpeedGreaterThan6000k>
<wirelineUploadSpeedGreaterThan10000k>0.00000</wirelineUploadSpeedGreaterThan10000k>
<wirelineUploadSpeedGreaterThan25000k>0.00000</wirelineUploadSpeedGreaterThan25000k>
<wirelineUploadSpeedGreaterThan50000k>0.00000</wirelineUploadSpeedGreaterThan50000k>
<wirelineUploadSpeedGreaterThan100000k>0.00000</wirelineUploadSpeedGreaterThan100000k>
<wirelineUploadSpeedGreaterThan1Gig>0.00000</wirelineUploadSpeedGreaterThan1Gig>
<wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>0.64600</wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.64600</wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan768k>0.89540</wirelessDownloadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan1500k>0.89540</wirelessDownloadSpeedGreaterThan1500k>
<wirelessDownloadSpeedGreaterThan3000k>0.00000</wirelessDownloadSpeedGreaterThan3000k>
<wirelessDownloadSpeedGreaterThan6000k>0.00000</wirelessDownloadSpeedGreaterThan6000k>
<wirelessDownloadSpeedGreaterThan10000k>0.00000</wirelessDownloadSpeedGreaterThan10000k>
<wirelessDownloadSpeedGreaterThan25000k>0.00000</wirelessDownloadSpeedGreaterThan25000k>
<wirelessDownloadSpeedGreaterThan50000k>0.00000</wirelessDownloadSpeedGreaterThan50000k>
<wirelessDownloadSpeedGreaterThan100000k>0.00000</wirelessDownloadSpeedGreaterThan100000k>
<wirelessDownloadSpeedGreaterThan1Gig>0.00000</wirelessDownloadSpeedGreaterThan1Gig>
<wirelessUploadSpeedLessThan200k>0.00000</wirelessUploadSpeedLessThan200k>
<wirelessUploadSpeedGreaterThan200k>0.89540</wirelessUploadSpeedGreaterThan200k>
<wirelessUploadSpeedGreaterThan768k>0.89540</wirelessUploadSpeedGreaterThan768k>
<wirelessUploadSpeedGreaterThan1500k>0.00000</wirelessUploadSpeedGreaterThan1500k>
<wirelessUploadSpeedGreaterThan3000k>0.00000</wirelessUploadSpeedGreaterThan3000k>
<wirelessUploadSpeedGreaterThan6000k>0.00000</wirelessUploadSpeedGreaterThan6000k>
<wirelessUploadSpeedGreaterThan10000k>0.00000</wirelessUploadSpeedGreaterThan10000k>
<wirelessUploadSpeedGreaterThan25000k>0.00000</wirelessUploadSpeedGreaterThan25000k>
<wirelessUploadSpeedGreaterThan50000k>0.00000</wirelessUploadSpeedGreaterThan50000k>
<wirelessUploadSpeedGreaterThan100000k>0.00000</wirelessUploadSpeedGreaterThan100000k>
<wirelessUploadSpeedGreaterThan1Gig>0.00000</wirelessUploadSpeedGreaterThan1Gig>
<wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>0.89540</wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.00000</wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<anyTechnology>0.90800</anyTechnology>
<anyWireline>0.64600</anyWireline>
<dsl>0.64600</dsl>
<asymmetricDsl>0.64600</asymmetricDsl>
<symmetricDsl>0.00000</symmetricDsl>
<copper>0.00000</copper>
<cable>0.00000</cable>
<cableDocsis>0.00000</cableDocsis>
<cableOther>0.00000</cableOther>
<opticalFiber>0.00000</opticalFiber>
<powerline>0.00000</powerline>
<anyWireless>0.89540</anyWireless>
<satellite>0.00000</satellite>
<fixedWireless>0.00000</fixedWireless>
<fixedWirelessUnlicensed>0.00000</fixedWirelessUnlicensed>
<fixedWirelessLicensed>0.00000</fixedWirelessLicensed>
<mobileWireless>0.89540</mobileWireless>
<otherTechnology>0.00000</otherTechnology>
<mostCommonDownloadSpeed>4.00000</mostCommonDownloadSpeed>
<mostCommonDownloadSpeedPercentage>0.90800</mostCommonDownloadSpeedPercentage>
<greatestDownloadSpeed>7.00000</greatestDownloadSpeed>
<greatestDownloadSpeedPercentage>0.61710</greatestDownloadSpeedPercentage>
<mostCommonUploadSpeed>3.00000</mostCommonUploadSpeed>
<mostCommonUploadSpeedPercentage>0.90800</mostCommonUploadSpeedPercentage>
<greatestUploadSpeed>5.00000</greatestUploadSpeed>
<greatestUploadSpeedPercentage>0.61710</greatestUploadSpeedPercentage>
</providerStatistics>
<statesServedByProvider>01</statesServedByProvider>
<statesServedByProvider>02</statesServedByProvider>
<statesServedByProvider>04</statesServedByProvider>
<statesServedByProvider>05</statesServedByProvider>
<statesServedByProvider>06</statesServedByProvider>
<statesServedByProvider>08</statesServedByProvider>
<statesServedByProvider>09</statesServedByProvider>
<statesServedByProvider>10</statesServedByProvider>
<statesServedByProvider>11</statesServedByProvider>
<statesServedByProvider>12</statesServedByProvider>
<statesServedByProvider>13</statesServedByProvider>
<statesServedByProvider>15</statesServedByProvider>
<statesServedByProvider>16</statesServedByProvider>
<statesServedByProvider>17</statesServedByProvider>
<statesServedByProvider>18</statesServedByProvider>
<statesServedByProvider>19</statesServedByProvider>
<statesServedByProvider>20</statesServedByProvider>
<statesServedByProvider>21</statesServedByProvider>
<statesServedByProvider>22</statesServedByProvider>
<statesServedByProvider>23</statesServedByProvider>
<statesServedByProvider>24</statesServedByProvider>
<statesServedByProvider>25</statesServedByProvider>
<statesServedByProvider>26</statesServedByProvider>
<statesServedByProvider>27</statesServedByProvider>
<statesServedByProvider>28</statesServedByProvider>
<statesServedByProvider>29</statesServedByProvider>
<statesServedByProvider>30</statesServedByProvider>
<statesServedByProvider>31</statesServedByProvider>
<statesServedByProvider>32</statesServedByProvider>
<statesServedByProvider>33</statesServedByProvider>
<statesServedByProvider>34</statesServedByProvider>
<statesServedByProvider>35</statesServedByProvider>
<statesServedByProvider>36</statesServedByProvider>
<statesServedByProvider>37</statesServedByProvider>
<statesServedByProvider>38</statesServedByProvider>
<statesServedByProvider>39</statesServedByProvider>
<statesServedByProvider>40</statesServedByProvider>
<statesServedByProvider>41</statesServedByProvider>
<statesServedByProvider>42</statesServedByProvider>
<statesServedByProvider>44</statesServedByProvider>
<statesServedByProvider>45</statesServedByProvider>
<statesServedByProvider>46</statesServedByProvider>
<statesServedByProvider>47</statesServedByProvider>
<statesServedByProvider>48</statesServedByProvider>
<statesServedByProvider>49</statesServedByProvider>
<statesServedByProvider>50</statesServedByProvider>
<statesServedByProvider>51</statesServedByProvider>
<statesServedByProvider>53</statesServedByProvider>
<statesServedByProvider>54</statesServedByProvider>
<statesServedByProvider>55</statesServedByProvider>
<statesServedByProvider>56</statesServedByProvider>
<statesServedByProvider>72</statesServedByProvider>
<statesServedByProvider>78</statesServedByProvider>
</Results>
</Response>