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.
Latest data version released jun2012. Previous data versions include jun2011, dec2011.
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: jun2012, dec2011, 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":14,
"message":[
],
"Results":{
"providerStatistics":{
"geographyName":"01",
"holdingCompanyName":"AT&T Inc.",
"landArea":3841.57730000,
"population":692910,
"populationDensity":105,
"households":325618,
"raceWhite":0.69470,
"raceBlack":0.27060,
"raceHispanic":0.01900,
"raceAsian":0.00880,
"raceNativeAmerican":0.00690,
"incomeBelowPoverty":0.18720,
"medianIncome":47281.13270,
"incomeLessThan25":0.29480,
"incomeBetween25to50":0.32520,
"incomeBetween50to100":0.29810,
"incomeBetween100to200":0.11690,
"incomeGreater200":0.02750,
"educationHighSchoolGraduate":0.78110,
"educationBachelorOrGreater":0.19010,
"ageUnder5":0.05160,
"ageBetween5to19":0.20950,
"ageBetween20to34":0.20050,
"ageBetween35to59":0.32830,
"ageGreaterThan60":0.21020,
"wirelineDownloadSpeedGreaterThan768k":0.62680,
"wirelineDownloadSpeedGreaterThan1500k":0.61630,
"wirelineDownloadSpeedGreaterThan3000k":0.54110,
"wirelineDownloadSpeedGreaterThan6000k":0.50670,
"wirelineDownloadSpeedGreaterThan10000k":0.45080,
"wirelineDownloadSpeedGreaterThan25000k":0.00000,
"wirelineDownloadSpeedGreaterThan50000k":0.00000,
"wirelineDownloadSpeedGreaterThan100000k":0.00000,
"wirelineDownloadSpeedGreaterThan1Gig":0.00000,
"wirelineUploadSpeedLessThan200k":0.00000,
"wirelineUploadSpeedGreaterThan200k":0.62680,
"wirelineUploadSpeedGreaterThan768k":0.50670,
"wirelineUploadSpeedGreaterThan1500k":0.39700,
"wirelineUploadSpeedGreaterThan3000k":0.03440,
"wirelineUploadSpeedGreaterThan6000k":0.00000,
"wirelineUploadSpeedGreaterThan10000k":0.00000,
"wirelineUploadSpeedGreaterThan25000k":0.00000,
"wirelineUploadSpeedGreaterThan50000k":0.00000,
"wirelineUploadSpeedGreaterThan100000k":0.00000,
"wirelineUploadSpeedGreaterThan1Gig":0.00000,
"wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.62680,
"wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.50670,
"wirelessDownloadSpeedGreaterThan768k":0.98680,
"wirelessDownloadSpeedGreaterThan1500k":0.98680,
"wirelessDownloadSpeedGreaterThan3000k":0.94890,
"wirelessDownloadSpeedGreaterThan6000k":0.00000,
"wirelessDownloadSpeedGreaterThan10000k":0.00000,
"wirelessDownloadSpeedGreaterThan25000k":0.00000,
"wirelessDownloadSpeedGreaterThan50000k":0.00000,
"wirelessDownloadSpeedGreaterThan100000k":0.00000,
"wirelessDownloadSpeedGreaterThan1Gig":0.00000,
"wirelessUploadSpeedLessThan200k":0.00000,
"wirelessUploadSpeedGreaterThan200k":0.98680,
"wirelessUploadSpeedGreaterThan768k":0.98680,
"wirelessUploadSpeedGreaterThan1500k":0.94890,
"wirelessUploadSpeedGreaterThan3000k":0.94890,
"wirelessUploadSpeedGreaterThan6000k":0.00000,
"wirelessUploadSpeedGreaterThan10000k":0.00000,
"wirelessUploadSpeedGreaterThan25000k":0.00000,
"wirelessUploadSpeedGreaterThan50000k":0.00000,
"wirelessUploadSpeedGreaterThan100000k":0.00000,
"wirelessUploadSpeedGreaterThan1Gig":0.00000,
"wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.98680,
"wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.94890,
"anyTechnology":0.98690,
"anyWireline":0.62680,
"dsl":0.62580,
"asymmetricDsl":0.62580,
"symmetricDsl":0.00000,
"copper":0.00000,
"cable":0.00000,
"cableDocsis":0.00000,
"cableOther":0.00000,
"opticalFiber":0.00100,
"powerline":0.00000,
"anyWireless":0.98680,
"satellite":0.00000,
"fixedWireless":0.00000,
"fixedWirelessUnlicensed":0.00000,
"fixedWirelessLicensed":0.00000,
"mobileWireless":0.98680,
"otherTechnology":0.00000,
"mostCommonDownloadSpeed":3.00000,
"mostCommonDownloadSpeedPercentage":0.98690,
"greatestDownloadSpeed":7.00000,
"greatestDownloadSpeedPercentage":0.45080,
"mostCommonUploadSpeed":2.00000,
"mostCommonUploadSpeedPercentage":0.98690,
"greatestUploadSpeed":5.00000,
"greatestUploadSpeedPercentage":0.94890
},
"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="18">
<Results>
<providerStatistics>
<geographyName>01</geographyName>
<holdingCompanyName>AT&T Inc.</holdingCompanyName>
<landArea>3841.57730000</landArea>
<population>692910</population>
<populationDensity>105</populationDensity>
<households>325618</households>
<raceWhite>0.69470</raceWhite>
<raceBlack>0.27060</raceBlack>
<raceHispanic>0.01900</raceHispanic>
<raceAsian>0.00880</raceAsian>
<raceNativeAmerican>0.00690</raceNativeAmerican>
<incomeBelowPoverty>0.18720</incomeBelowPoverty>
<medianIncome>47281.13270</medianIncome>
<incomeLessThan25>0.29480</incomeLessThan25>
<incomeBetween25to50>0.32520</incomeBetween25to50>
<incomeBetween50to100>0.29810</incomeBetween50to100>
<incomeBetween100to200>0.11690</incomeBetween100to200>
<incomeGreater200>0.02750</incomeGreater200>
<educationHighSchoolGraduate>0.78110</educationHighSchoolGraduate>
<educationBachelorOrGreater>0.19010</educationBachelorOrGreater>
<ageUnder5>0.05160</ageUnder5>
<ageBetween5to19>0.20950</ageBetween5to19>
<ageBetween20to34>0.20050</ageBetween20to34>
<ageBetween35to59>0.32830</ageBetween35to59>
<ageGreaterThan60>0.21020</ageGreaterThan60>
<wirelineDownloadSpeedGreaterThan768k>0.62680</wirelineDownloadSpeedGreaterThan768k>
<wirelineDownloadSpeedGreaterThan1500k>0.61630</wirelineDownloadSpeedGreaterThan1500k>
<wirelineDownloadSpeedGreaterThan3000k>0.54110</wirelineDownloadSpeedGreaterThan3000k>
<wirelineDownloadSpeedGreaterThan6000k>0.50670</wirelineDownloadSpeedGreaterThan6000k>
<wirelineDownloadSpeedGreaterThan10000k>0.45080</wirelineDownloadSpeedGreaterThan10000k>
<wirelineDownloadSpeedGreaterThan25000k>0.00000</wirelineDownloadSpeedGreaterThan25000k>
<wirelineDownloadSpeedGreaterThan50000k>0.00000</wirelineDownloadSpeedGreaterThan50000k>
<wirelineDownloadSpeedGreaterThan100000k>0.00000</wirelineDownloadSpeedGreaterThan100000k>
<wirelineDownloadSpeedGreaterThan1Gig>0.00000</wirelineDownloadSpeedGreaterThan1Gig>
<wirelineUploadSpeedLessThan200k>0.00000</wirelineUploadSpeedLessThan200k>
<wirelineUploadSpeedGreaterThan200k>0.62680</wirelineUploadSpeedGreaterThan200k>
<wirelineUploadSpeedGreaterThan768k>0.50670</wirelineUploadSpeedGreaterThan768k>
<wirelineUploadSpeedGreaterThan1500k>0.39700</wirelineUploadSpeedGreaterThan1500k>
<wirelineUploadSpeedGreaterThan3000k>0.03440</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.62680</wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.50670</wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan768k>0.98680</wirelessDownloadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan1500k>0.98680</wirelessDownloadSpeedGreaterThan1500k>
<wirelessDownloadSpeedGreaterThan3000k>0.94890</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.98680</wirelessUploadSpeedGreaterThan200k>
<wirelessUploadSpeedGreaterThan768k>0.98680</wirelessUploadSpeedGreaterThan768k>
<wirelessUploadSpeedGreaterThan1500k>0.94890</wirelessUploadSpeedGreaterThan1500k>
<wirelessUploadSpeedGreaterThan3000k>0.94890</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.98680</wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.94890</wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<anyTechnology>0.98690</anyTechnology>
<anyWireline>0.62680</anyWireline>
<dsl>0.62580</dsl>
<asymmetricDsl>0.62580</asymmetricDsl>
<symmetricDsl>0.00000</symmetricDsl>
<copper>0.00000</copper>
<cable>0.00000</cable>
<cableDocsis>0.00000</cableDocsis>
<cableOther>0.00000</cableOther>
<opticalFiber>0.00100</opticalFiber>
<powerline>0.00000</powerline>
<anyWireless>0.98680</anyWireless>
<satellite>0.00000</satellite>
<fixedWireless>0.00000</fixedWireless>
<fixedWirelessUnlicensed>0.00000</fixedWirelessUnlicensed>
<fixedWirelessLicensed>0.00000</fixedWirelessLicensed>
<mobileWireless>0.98680</mobileWireless>
<otherTechnology>0.00000</otherTechnology>
<mostCommonDownloadSpeed>3.00000</mostCommonDownloadSpeed>
<mostCommonDownloadSpeedPercentage>0.98690</mostCommonDownloadSpeedPercentage>
<greatestDownloadSpeed>7.00000</greatestDownloadSpeed>
<greatestDownloadSpeedPercentage>0.45080</greatestDownloadSpeedPercentage>
<mostCommonUploadSpeed>2.00000</mostCommonUploadSpeed>
<mostCommonUploadSpeedPercentage>0.98690</mostCommonUploadSpeedPercentage>
<greatestUploadSpeed>5.00000</greatestUploadSpeed>
<greatestUploadSpeedPercentage>0.94890</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>