Internet speed test
CoverageMap API

Summary object

The summary object: 0 to 10 overall, performance, coverage and reliability scores for a carrier at a location.

Request the summary dataset for a simple answer to how a carrier performs at a location. The summary weighs the FCC coverage and speed test datasets into four scores from 0 to 10, with one decimal place, plus a few flags. You do not need to request the other datasets to get it. It is returned in the summary field of every coverage entry and costs 1 unit per location.

Example

Two coverage entries from a request with "datasets": ["summary"]. The first has speed tests nearby, so its scores are measured. The second has none, so its scores are estimated from FCC data alone:

Coverage entries
[
  {
    "provider": { "code": "VZW", "name": "Verizon Wireless" },
    "technology": { "code": "lte", "name": "LTE" },
    "summary": {
      "overall": 8.6,
      "performance": 7.9,
      "coverage": 9.5,
      "reliability": 7.7,
      "isFullyCovered": true,
      "source": "measured",
      "accuracy": "exact"
    }
  },
  {
    "provider": { "code": "ATT", "name": "AT&T Mobility" },
    "technology": { "code": "lte", "name": "LTE" },
    "summary": {
      "overall": 6.2,
      "performance": 5.1,
      "coverage": 7.4,
      "reliability": 4.8,
      "isFullyCovered": false,
      "source": "estimated",
      "accuracy": null
    }
  }
]

When the FCC has nothing for the provider and technology and there are no nearby speed tests, every score is 0:

No coverage
{
  "provider": { "code": "TMO", "name": "T-Mobile US" },
  "technology": { "code": "5g", "name": "5GNR" },
  "summary": {
    "overall": 0,
    "performance": 0,
    "coverage": 0,
    "reliability": 0,
    "isFullyCovered": false,
    "source": "estimated",
    "accuracy": null
  }
}

The field is only null when there are no nearby speed tests and no FCC data is available for the location, for example outside the US:

No data outside the US
{
  "provider": { "code": "BELL", "name": "Bell Mobility Inc." },
  "technology": { "code": "5g", "name": "5GNR" },
  "summary": null
}

Attributes

Every score is a number from 0 to 10 where 10 is best. The scores are followed by three fields that say how they were produced.

overallnumber
One score that blends coverage, reliability and performance, weighting coverage most, then reliability, then performance.
performancenumber
Based on the speeds and response times of nearby tests, and lowered by failed tests. Falls back to FCC data when there are no nearby tests.
coveragenumber
Based on FCC data and how often nearby tests got a usable connection. Failed or very slow tests nearby lower it, even where the FCC reports coverage.
reliabilitynumber
Based on the slowest nearby tests and failed tests, together with the weakest FCC coverage around the location. Falls back to FCC data when there are no nearby tests.
isFullyCoveredboolean
True when the FCC reports the whole area within 0.5 km as covered.
sourcestring
measured when speed tests were used; estimated when the scores come from FCC data alone. Estimated performance and reliability are discounted because nothing was measured on the ground.

Possible values: measured, estimated

accuracystringNullable
How close the tests used were: exact for the tested area the location sits in, high within 0.5 km, medium within 1 km and low within 2 km. Null when the summary is estimated.

Possible values: exact, high, medium, low

What the scores mean

The scores are there to keep things simple, so you can act on them without working through the numbers behind them. Each one falls into one of four ratings.

Coverage

Can you get a usable connection here?

Coverage score ratings
ScoreRatingConnections that workWhat it means
8 – 10Good8+ in 10Connections reliably work here.
5 – 7.9Fair5–8 in 10Usually works, but some attempts fail or are very weak.
2 – 4.9Poor2–5 in 10A coverage issue: most attempts fail or barely work.
0 – 1.9NoneUnder 2 in 10No workable coverage.

Performance

How fast is it when connected?

Performance score ratings
ScoreRatingTypical downloadWhat it means
8 – 10Fast80+ MbpsHandles anything, including HD video and large downloads.
5 – 7.9Good50–80 MbpsComfortable for streaming, video calls and everyday use.
2 – 4.9Basic20–50 MbpsFine for browsing, email and messaging. Video may struggle.
0 – 1.9SlowUnder 20 MbpsConnected, but only light use is practical.

Reliability

Does it stay usable at its worst moments?

Reliability score ratings
ScoreRatingSlowest speedsWhat it means
8 – 10Consistent8+ MbpsStays usable even at its slowest.
5 – 7.9Mostly steady5–8 MbpsOccasional slowdowns.
2 – 4.9Inconsistent2–5 MbpsFrequent slowdowns or dropped connections.
0 – 1.9UnreliableUnder 2 MbpsOften unusable.

Overall

A single rating for the location.

Overall score ratings
ScoreRatingWhat it means
8 – 10ExcellentA strong choice for this location.
5 – 7.9GoodWorkable, with some weak spots.
2 – 4.9WeakExpect problems.
0 – 1.9PoorNot recommended for this location.

Overall weighs coverage most heavily. Use the coverage score to decide whether there is a coverage issue.

How confident is the score?

The source and accuracy fields say how much to trust the scores, based on how close the speed tests behind them were to the location:

How confident is the score
source / accuracyConfidenceTests withinMeaning
measured + exact or highHigh0.5 kmBased on real tests at or very near the location.
measured + mediumModerate1 kmBased on real tests nearby.
measured + lowModerate2 kmBased on real tests in the wider area.
estimatedIndicativeNoneBased on FCC data only.

Confirming a coverage issue

A coverage score below 5 with High confidence is a confirmed coverage issue. A low score with Indicative confidence is a signal to investigate, not proof.

Notes

  • Measured scores use the smallest radius that has both download and upload tests, so they pool every test around the location rather than relying on one tested area.
  • The summary is only unavailable, and unbilled, when both of its inputs were temporarily unavailable for the whole response. When only one is missing the scores are still returned and source says which data they came from.