Open EV Data

A comprehensive database of electric vehicle specifications, focusing on charging capabilities and energy consumption.

In contrast to ICE cars, electric vehicles have very different behaviors in terms of charging and charging speed. Having reliable data about a car is key for developing EV-related applications.

This dataset (data/ev-data.json) can be freely integrated into ANY application under the terms of our license. Attribution is required.

This data is used for Kilowatt – Electric Car Timer app available on the Apple App Store.

Available Data

At the moment mostly charging related data is available. Feel free to add more data if you need it!

You can also search through our data set!.

Data Formats

V1 Format (Legacy)

The original format is available in data/ev-data.json. This single file contains all vehicle and brand information.

V2 Format (Current)

The current format splits the data into multiple files for better maintainability. See V2 Format Documentation for details.

Data Structure

Each vehicle entry contains:

• Basic information (brand, model, variant, release year)
• Battery specifications
• AC charging capabilities
• DC charging capabilities (optional)
• Energy consumption data

Validation

The data is validated using Ruby-based validators that ensure:

• Data integrity and consistency
• Valid charging specifications
• Correct relationships between brands and vehicles
• Proper UUID formats
• Valid charging curves and power levels

Scripts

• scripts/update_meta.rb: Updates meta information in the v2 format
• scripts/split_data.rb: Converts data from v1 format (ev-data.json) to v2 format (multiple files)
• scripts/merge_data.rb: Converts data from v2 format (multiple files) back to v1 format (ev-data.json)

Data Conversion Scripts

Split Data (V1 → V2)

The split_data.rb script splits the single v1 format file into the multi-file v2 format:

ruby scripts/split_data.rb

This creates:

• data/v2/brands.json - Contains brand information and references to model files
• data/v2/models/*.json - Individual files for each brand's models

Merge Data (V2 → V1)

The merge_data.rb script combines the v2 format files back into the single v1 format file:

ruby scripts/merge_data.rb [options]

Options:

• -i, --input DIRECTORY - Input directory containing V2 format data (default: data/v2)
• -o, --output FILE - Output file path for V1 format data (default: data/ev-data.json)
• -v, --verbose - Enable verbose output
• -f, --fix-duplicates - Fix duplicate IDs by generating new UUIDs
• -h, --help - Show help message

This is useful when you've been modifying data in the v2 format and need to update the v1 format file.

Change Requests

Please file an issue if you have a change request.

Contributing

We are always looking for people who want to contribute to the project! Feel free to open a PR to contribute!

Documentation

For detailed documentation, please visit our Open EV Data Website.

License

This dataset is released under the MIT License with Attribution Requirement. This means you can freely use this data in your projects, but you must include attribution to Open EV Data.

Attribution Requirements

When using this dataset in your project, you must include a clear and visible attribution to "Open EV Data" in one of the following locations:

• About page or section
• Documentation
• README file

See the LICENSE file for the complete terms.