DeveloperAPI » Wireline Broadband API
Description
This API returns all the wireline providers within a US census block given a passed latitude and longitude.
Latest data version released jun2012. Previous data versions include jun2011, dec2011.
Starting with jun2012 data, API responses will include new quality scores (maximum scores for each metric, as well as upload and download speed quality). The previous data versions dec2011 and jun2011 do not include these additional quality scores.
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 retrieve the full list of wireline broadband providers at a given location (e.g. latitude and longitude).
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/broadband/{dataVersion}/wireline?latitude={latitude}&longitude={longitude}&maxresults={maxResults}&format={format}&callback={functionName}//
Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2012, dec2011, jun2011.
latitude:
latitude of a point. Example: 41.486857
longitude:
longitude of a point. Example: -71.294392
Optional Parameters
maxResults:
specify the maximum results to be returned - defaulted to 100
format (optional):
XML, JSON, JSONP (XML is default)
callback (optional)
JSONP callback function name
{ "status":"OK", "responseTime":7, "message":[ ], "Results":{ "wirelineServices":[ { "blockFIPS":"360775908001027", "frn":"0013430244", "providerName":"Time Warner Cable LLC", "doingBusinessAs":"Time Warner Cable", "holdingCompanyNumber":"131352", "holdingCompanyName":"Time Warner Cable Inc.", "providerURL":"www.timewarnercable.com", "technologies":[ { "technologyCode":41, "typicalDownloadSpeed":0, "typicalUploadSpeed":0, "maximumAdvertisedDownloadSpeed":7, "maximumAdvertisedUploadSpeed":3, "overallQuality":1, "speedQuality":2.00, "technologyQuality":3.00, "providerQuality":3.00, "downloadQuality":2.00, "uploadQuality":1.00, "maximumProviderScore":3.00, "maximumTechnologyScore":3.00, "maximumSpeedScore":2.00, "maximumDownloadScore":2.00, "maximumUploadScore":2.00 } ] }, { "blockFIPS":"360775908001027", "frn":"0003469442", "providerName":"Verizon New York Inc.", "doingBusinessAs":"Verizon New York", "holdingCompanyNumber":"131425", "holdingCompanyName":"Verizon Communications Inc.", "providerURL":"www22.verizon.com", "technologies":[ { "technologyCode":10, "typicalDownloadSpeed":0, "typicalUploadSpeed":0, "maximumAdvertisedDownloadSpeed":5, "maximumAdvertisedUploadSpeed":3, "overallQuality":2, "speedQuality":0.00, "technologyQuality":0.00, "providerQuality":1.00, "downloadQuality":0.00, "uploadQuality":0.00, "maximumProviderScore":2.00, "maximumTechnologyScore":1.00, "maximumSpeedScore":0.00, "maximumDownloadScore":0.00, "maximumUploadScore":0.00 } ] } ], "broadbandSource":{ "stateFips":"36", "organization":"The New York State Office of Cyber Security", "organizationURL":"http://www.cscic.state.ny.us/broadband/" } } }
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response status="OK" responseTime="7"> <Results> <wirelineServices> <blockFIPS>360775908001027</blockFIPS> <frn>0013430244</frn> <providerName>Time Warner Cable LLC</providerName> <doingBusinessAs>Time Warner Cable</doingBusinessAs> <holdingCompanyNumber>131352</holdingCompanyNumber> <holdingCompanyName>Time Warner Cable Inc.</holdingCompanyName> <providerURL>www.timewarnercable.com</providerURL> <technologies> <technologyCode>41</technologyCode> <typicalDownloadSpeed>0</typicalDownloadSpeed> <typicalUploadSpeed>0</typicalUploadSpeed> <maximumAdvertisedDownloadSpeed>7</maximumAdvertisedDownloadSpeed> <maximumAdvertisedUploadSpeed>3</maximumAdvertisedUploadSpeed> <overallQuality>1</overallQuality> <speedQuality>2.00</speedQuality> <technologyQuality>3.00</technologyQuality> <providerQuality>3.00</providerQuality> <downloadQuality>2.00</downloadQuality> <uploadQuality>1.00</uploadQuality> <maximumProviderScore>3.00</maximumProviderScore> <maximumTechnologyScore>3.00</maximumTechnologyScore> <maximumSpeedScore>2.00</maximumSpeedScore> <maximumDownloadScore>2.00</maximumDownloadScore> <maximumUploadScore>2.00</maximumUploadScore> </technologies> </wirelineServices> <wirelineServices> <blockFIPS>360775908001027</blockFIPS> <frn>0003469442</frn> <providerName>Verizon New York Inc.</providerName> <doingBusinessAs>Verizon New York</doingBusinessAs> <holdingCompanyNumber>131425</holdingCompanyNumber> <holdingCompanyName>Verizon Communications Inc.</holdingCompanyName> <providerURL>www22.verizon.com</providerURL> <technologies> <technologyCode>10</technologyCode> <typicalDownloadSpeed>0</typicalDownloadSpeed> <typicalUploadSpeed>0</typicalUploadSpeed> <maximumAdvertisedDownloadSpeed>5</maximumAdvertisedDownloadSpeed> <maximumAdvertisedUploadSpeed>3</maximumAdvertisedUploadSpeed> <overallQuality>2</overallQuality> <speedQuality>0.00</speedQuality> <technologyQuality>0.00</technologyQuality> <providerQuality>1.00</providerQuality> <downloadQuality>0.00</downloadQuality> <uploadQuality>0.00</uploadQuality> <maximumProviderScore>2.00</maximumProviderScore> <maximumTechnologyScore>1.00</maximumTechnologyScore> <maximumSpeedScore>0.00</maximumSpeedScore> <maximumDownloadScore>0.00</maximumDownloadScore> <maximumUploadScore>0.00</maximumUploadScore> </technologies> </wirelineServices> <broadbandSource> <stateFips>36</stateFips> <organization>The New York State Office of Cyber Security</organization> <organizationURL>http://www.cscic.state.ny.us/broadband/</organizationURL> </broadbandSource> </Results> </Response>