epidata_call: An abstraction that holds information needed to make an...

In cmu-delphi/delphi-epidata-r: Client for Delphi's 'Epidata' API

An abstraction that holds information needed to make an epidata request

Description

epidata_call objects are generated internally by endpoint functions like pub_covidcast; by default, they are piped directly into the fetch function to fetch and format the data. For most endpoints this will return a tibble, but a few non-COVIDCAST endpoints will return a JSON-like list instead.

Usage

create_epidata_call(
  endpoint,
  params,
  meta = NULL,
  only_supports_classic = FALSE
)

fetch(epidata_call, fetch_args = fetch_args_list())

Arguments

endpoint	the epidata endpoint to call
params	the parameters to pass to the epidata endpoint
meta	meta data to attach to the epidata call
only_supports_classic	if true only classic format is supported
epidata_call	an instance of epidata_call
fetch_args	a fetch_args object

Details

create_epidata_call is the constructor for epidata_call objects, but you should not need to use it directly; instead, use an endpoint function, e.g., pub_covidcast, to generate an epidata_call for the data of interest.

There are some other functions available for debugging and advanced usage: - request_url (for debugging): outputs the request URL from which data would be fetched (note additional parameters below)

fetch usually returns the data in tibble format, but a few of the endpoints only support the JSON classic format (pub_delphi, pvt_meta_norostat, and pub_meta). In that case a JSON-like nested list structure is returned instead.

Value

• For create_epidata_call: an epidata_call object

• For fetch: a tibble or a JSON-like list

Examples

## Not run: 
call <- pub_covidcast(
  source = "jhu-csse",
  signals = "confirmed_7dav_incidence_prop",
  time_type = "day",
  geo_type = "state",
  time_values = epirange(20200601, 20200801),
  geo_values = c("ca", "fl"),
  fetch_args = fetch_args_list(dry_run = TRUE)
)
call %>% fetch()

## End(Not run)

cmu-delphi/delphi-epidata-r documentation built on June 15, 2025, 10:33 a.m.