openaq

1.0.0

Access Air Quality Data from the 'OpenAQ' API

0packages depend

2.1Kdownloads / year

95.1%test coverage

13/13checks pass

Overview

About

Maintained by Russ BiggsFirst published 2026-03-191 releasesCRAN page ↗GitHub ↗

Provides an interface to the 'OpenAQ' API https://openaq.org/, a platform for real-time and historical air quality data from around the world. Users can retrieve measurement data, metadata for sensors and locations for air quality research and monitoring.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("openaq", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("openaq/openaq-r")

Development version from openaq/openaq-r. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-openaq

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-openaq

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-openaq

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 1.7 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.93

95.1%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-05-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
WARNING2026-05-06
12 OK · 0 NOTE · 1 WARNING · 0 ERROR · 0 FAILURE
OK2026-04-25
12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-03-21
8 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-20
5 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 214 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 100%
Return-value docs: 100%
References docs: 0%

Downloads

2.1K

CRAN downloads in the past year

Rank #7,542 · ~6/day · ~173/mo

Releases R versions

Daily download trend is not available in this view yet.

32630 days

1.4K90 days

2.1K1 year

Compare downloads with other packages →

Also on27 r2u42 autocran

Repository

GitHub ↗ openaq/openaq-r

12Stars

4Forks

2Open issues

1Open PRs

12Releases

92Commits

2Contributors

air-qualityapiopenaqr

92 commits · Last activity 2026-07-15 · +9.1% stars, 30d

Stars over time

2025-05-15 · 72026-07-10 · 12

Repository practices

Upstream repositoryBeta

7 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/openaq/openaq-r on 2026-07-19.

Continuous integration (1)

GitHub Actions

CRAN release process (1)

cran-comments.md

Lint, format, editor (2)

lintrRStudio project

Governance and community (2)

Issue templatesFunding

Show all practices

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1.0

Imports (4)

httr2 rstudioapimethodslubridate

LinkingTo (0)

none

Suggests (11)

testthat webmockr vcr withr knitr maps rmarkdown sf spelling jsonlite mockery

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Code Composition

R 4,534 (50%)Rd 1,889 (21%)Vignettes 1,204 (13%)YAML 942 (10%)JSON 529 (6%)Markdown 28 (0%)

Code characteristics

Object systems

S315

Cyclomatic complexity: 3.0 median / 16 max
Test cases: 136 / 0.93 per code line

Test coverage

Line coverage

95%

Expression

91.8%

Tests / Examples

95.1% / 0% ex

Functions

82 36 exported

Complexity

2.7 avg / 16 max

Call network

82 nodes / 84 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

82 functions

Function	Cyclo	Coverage
plot.openaq_locations_data.frame	2	0%
plot.openaq_locations_list	1	0%
plot.openaq_measurements_data.frame	1	0%
plot.openaq_measurements_list	1	0%
handle_request	4	50%
list_sensor_measurements exp	6	80%

People & History

People (4)

Maintainer (1)

Russ Biggs

Author, Maintainer

Authors (2)

Russ Biggs

Author, Maintainer

Christian Parker

Author

Contributors (1)

Francesca Mills

Contributor

OpenAQ

Funders (1)

OpenAQ

Package Timeline

1 release. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.0.0Latest
2026-03-19 · current release
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2026-03-19
Total releases: 1 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: not tracked yet
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →