DeveloperAPI » Provider Statistics API - Similar Providers Within Nation
Description
This API returns similar providers with the same availability as a provider based on either technologies or same most common upload/download speed or population served within the Nation. This API would return +3/-3 providers with similar availability.
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 similar providers as a provider within the nation.
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/provider/{dataVersion}/stats/nation/{censusMetric}/{holdingCompanyNumber}/similar/{searchCriteria}?format={format}&callback={functionName}
Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2011
censusMetric:
specify the census metric by which the data has to be aggregated. It can be only population as of now.
holdingCompanyNumber:
specify the holding company number of the provider using Provider by Geography API.
searchCriteria:
specify the search critieria by which similar provider needs to be retrieved.
Optional Parameters
format:
XML, JSON, JSONP (XML is default)
callback:
JSONP callback function name
{ "status":"OK", "responseTime":20, "message":[ ], "Results":{ "similarProviders":[ { "holdingCompanyNumber":"130077", "holdingCompanyName":"AT&T Inc.", "percentageAvailability":0.38160 }, { "holdingCompanyNumber":"130418", "holdingCompanyName":"Platinum Equity, LLC", "percentageAvailability":0.22880 }, { "holdingCompanyNumber":"131425", "holdingCompanyName":"Verizon Communications Inc.", "percentageAvailability":0.19760 }, { "holdingCompanyNumber":"130228", "holdingCompanyName":"CenturyTel, Inc.", "percentageAvailability":0.13620 } ] } }
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response status="OK" responseTime="13"> <Results> <similarProviders> <holdingCompanyNumber>130077</holdingCompanyNumber> <holdingCompanyName>AT&T Inc.</holdingCompanyName> <percentageAvailability>0.38160</percentageAvailability> </similarProviders> <similarProviders> <holdingCompanyNumber>130418</holdingCompanyNumber> <holdingCompanyName>Platinum Equity, LLC</holdingCompanyName> <percentageAvailability>0.22880</percentageAvailability> </similarProviders> <similarProviders> <holdingCompanyNumber>131425</holdingCompanyNumber> <holdingCompanyName>Verizon Communications Inc.</holdingCompanyName> <percentageAvailability>0.19760</percentageAvailability> </similarProviders> <similarProviders> <holdingCompanyNumber>130228</holdingCompanyNumber> <holdingCompanyName>CenturyTel, Inc.</holdingCompanyName> <percentageAvailability>0.13620</percentageAvailability> </similarProviders> </Results> </Response>