caRecall (version 0.1.0)

count_recall_by_make: Count of recalls searching by make or manufacturer

Description

Returns the count of recalls in the Vehicle Recalls Database based on a make or manufacturer search term.

Usage

count_recall_by_make(
  make,
  manufacturer = FALSE,
  start_year = NULL,
  end_year = NULL,
  api_key = NULL
)

Arguments

make

List of make or manufacturer names.

manufacturer

Logical; if TRUE, manufacturer is searched on instead of make.

start_year

Start of year range (optional).

end_year

End of year range (optional).

api_key

API access key to use, if not set in environment.

Value

A tibble providing the count of recalls from the Vehicle Recalls.

Details

Queries the Vehicle Recalls Database API by make or manufacturer and returns the count of recalls in the database. The year range of the search can be specified and is based on the manufactured year and not the year a recall occurred.

An API key is required to run the function and query the Vehicle Recalls Database. The key can be acquired at https://tc.api.canada.ca/en/detail?api=VRDB.

The API key can be set in the environment using Sys.setenv(VRD_API = 'your_API_key_here') and will be used by the function, or can be passed into the function using the api_key argument.

Examples

# NOT RUN {
count_recall_by_make("Nissan")
count_recall_by_make(c("Mazda", "Toyota"), start_year = 2008)
API_KEY <- "xxxxxxxxxxx"
count_recall_by_make("Maz", end_year = 2000, api_key = API_KEY)
# }