Developer

API » 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}//

Sample Call
http://www.broadbandmap.gov/broadbandmap/broadband/jun2012/wireline?latitude=42.456&longitude=-74.987&format=json

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

Response

JSON   XML

{
 "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>




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.