Fuel Economy Gov
Perform chained queries on the fueleconomy.gov dataset
Overview · Install · Sample · API · Tests
Overview
Fuel Economy Gov allows you to search through vehicle records from the fueleconomy.gov website based on criteria you specify. You can find vehicles by make, model, year, MPG, etc.
Design -
The queries follow a chaining pattern, allowing you to specify as few or as many constraints as you wish (see API list for details). Once the query is assembled, call .search()
with a callback of the form cb(cars), where cars will be an array of records that met the criteria.
All the data (back to 1984) is packed in a .csv file obtained from the "Download the Vehicle Data" section of the .gov website. Integration with their web service API is expected for this module.
Why? This was made to support projects that provide vehicle search capabilities to users. The data is from fueleconomy.gov, so it's main focus is on fuel efficiency and emissions.
Install
npm install fueleconomygov
Sample
var FuelEconomy = ; ; ; // Queries can be chained together to be more specific;
API
The following functions can be chained together on the new FuelEconomy()
clause to specify search constraints. As demonstrated above, call .search()
with a callback to get the records found.
make stringmodel stringyear numberminYear numbermaxYear numbermpg numberminMpg numbermaxMpg number
Tests
Run npm test
to execute the Mocha tests. Each test takes a few seconds because the streaming query has to go through tens of thousands of records.