get_performance_tiles: Pull Performance Tiles

In teamookla/ooklaOpenDataR: Work with 'Speedtest by Ookla' Global Internet Performance Data

Description

get_performance_tiles() retrieves Ookla broadband performance data for a given quarter. Data are grouped and summarized by quadkey using a zoom level of 16. This equates to a tile that is approximately 610.8 meters by 610.8 meters at the equator (18 arcsecond blocks).

Usage

get_performance_tiles(
  service = c("mobile", "fixed"),
  year,
  quarter,
  sf = FALSE,
  ...
)

Arguments

service	Either 'mobile' or 'fixed' depending on whether you want mobile network or fixed broadband data
year	Numeric value indicating the year of the time period of interest (e.g., 2020)
quarter	Numeric value indicating the quarter of interest (e.g., 2 for Q2)
sf	Whether or not to return object as sf dataframe (default: FALSE)
...	Additional arguments passed to arrow::read_parquet()

Value

A data frame or sf data frame with the following fields:

• avg_d_kbps: The average download speed of all tests performed in the tile, represented in kilobits per second

• avg_u_kbps: The average upload speed of all tests performed in the tile, represented in kilobits per second

• avg_lat_ms: The average latency of all tests performed in the tile, represented in milliseconds

• tests: The number of tests taken in the tile

• devices: The number of unique devices contributing tests in the tile

• quadkey: The quadkey representing the tile. Quadkeys can act as a unique identifier for the tile.

• tile: The WKT representation of tile geometry

Examples

## Not run: 
# Pulls all fixed broadband tiles from Q2 2020 and returns an `sf` data frame
get_performance_tiles(service = "fixed", year = 2020, quarter = 2, sf = TRUE)

# Get mobile quadkey and average download speeds for Q1 2020
get_performance_tiles(service = "mobile", year = 2020, quarter = 1, col_select = c("quadkey", "avg_d_kbps"))

## End(Not run)

teamookla/ooklaOpenDataR documentation built on Oct. 23, 2021, 9:48 a.m.