https://github.com/open-ev-data/open-ev-data-dataset
This repository provides a structured, versioned, and community-maintained dataset of electric vehicle specifications. Vehicle data is authored as layered JSON fragments and compiled into canonical, fully-expanded vehicle records suitable for analysis, comparison, and integration.
https://github.com/open-ev-data/open-ev-data-dataset
csv docker json merge node open-ev-data postgresql sqlite xml
Last synced: 10 days ago
JSON representation
This repository provides a structured, versioned, and community-maintained dataset of electric vehicle specifications. Vehicle data is authored as layered JSON fragments and compiled into canonical, fully-expanded vehicle records suitable for analysis, comparison, and integration.
- Host: GitHub
- URL: https://github.com/open-ev-data/open-ev-data-dataset
- Owner: open-ev-data
- License: other
- Created: 2025-12-24T18:15:23.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-12-30T18:57:15.000Z (24 days ago)
- Last Synced: 2026-01-07T14:25:14.211Z (17 days ago)
- Topics: csv, docker, json, merge, node, open-ev-data, postgresql, sqlite, xml
- Language: JavaScript
- Homepage: https://open-ev-data.github.io/
- Size: 709 KB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING_VEHICLES.md
Awesome Lists containing this project
README
# OpenEV Data Dataset
> A canonical, open dataset of electric vehicle specifications following a Layered Canonical Dataset (LCD) architecture.
[](LICENCE)
[](https://github.com/open-ev-data/open-ev-data-dataset/releases)
## Overview
This repository provides a **structured, versioned, and community-maintained dataset** of electric vehicle specifications. Vehicle data is authored as **layered JSON fragments** and compiled into **canonical, fully-expanded vehicle records** suitable for analysis, comparison, and integration.
## Documentation
### Getting Started
- **[How to Consume](docs/HOW_TO_CONSUME.md)** — Complete guide on using the dataset in all available formats with examples
### Repository Documentation
- **[Architecture](docs/ARCHITECTURE.md)** — Repository architecture, layered data model, build process, and authoring rules
- **[Schema Reference](docs/SCHEMA.md)** — Complete field-by-field documentation of the vehicle data schema
- **[Contributing Vehicles](docs/CONTRIBUTING_VEHICLES.md)** — Step-by-step guide to add new vehicles and validate changes
### Project Governance
- **[Getting Started](https://github.com/open-ev-data/.github/blob/main/GET_STARTED.md)** — How to set up the complete development environment with all repositories
- **[Contributing Guide](https://github.com/open-ev-data/.github/blob/main/CONTRIBUTING.md)** — How to contribute, data quality standards, and commit message guidelines
- **[Code of Conduct](https://github.com/open-ev-data/.github/blob/main/CODE_OF_CONDUCT.md)** — Community standards and expected behavior
## Data Coverage
This dataset aims to cover:
- **Vehicle identity**: Make, model, year, trim, and variant configurations
- **Battery system**: Chemistry, capacity (gross/net), voltage, cell/module count, thermal management, warranty, preconditioning
- **Charging infrastructure**: Charge ports (Type 1, Type 2, CCS1, CCS2, NACS, CHAdeMO, GB/T), location, and features
- **Charging capabilities**: AC (power, phases, onboard charger), DC fast charging (peak power, voltage class, curves, protocols)
- **Bidirectional charging (V2X)**: V2L (Vehicle-to-Load), V2H (Vehicle-to-Home), V2G (Vehicle-to-Grid)
- **Range and efficiency**: Rated cycles (WLTP, EPA, NEDC, CLTC, JC08), real-world estimates, energy consumption
- **Powertrain**: Motor configuration, power, torque, drivetrain, transmission
- **Performance**: Acceleration (0-100 km/h, 0-60 mph), top speed, quarter mile
- **Physical specifications**: Dimensions, weight, cargo capacity, towing capacity
- **Wheels and tires**: Sizes, recommended pressures
- **Market data**: Availability status, markets (by country), pricing (MSRP)
- **Software**: Operating system, OTA update support
- **Sources and metadata**: Verifiable sources, data quality indicators, contributors
## Use Cases
- **Research**: EV market analysis, charging infrastructure planning
- **Applications**: EV comparison tools, range calculators, charging time estimators
- **APIs**: Backend data source for automotive applications
- **Education**: Learning about EV technology and specifications
## Quick Start
### Download Latest Release
```bash
LATEST_TAG=$(curl -s https://api.github.com/repos/open-ev-data/open-ev-data-dataset/releases/latest | jq -r .tag_name)
curl -L -o open-ev-data.json "https://github.com/open-ev-data/open-ev-data-dataset/releases/download/$LATEST_TAG/open-ev-data-$LATEST_TAG.json"
```
### Run with Docker Compose Latest Release Version
Start the complete stack with API and pre-populated database:
```bash
docker-compose up -d
```
Access the API at `http://localhost:8080/api/v1/vehicles`
See [How to Consume](docs/HOW_TO_CONSUME.md) for detailed usage examples in all formats.
## License
This project is licensed under the **Community Data License Agreement - Permissive, Version 2.0 (CDLA-Permissive-2.0)**.
In summary:
- Free to use, modify, and share
- No restrictions on results or derivatives
- No warranty provided
See [LICENCE](LICENCE) for full terms.
## Acknowledgments
This project is inspired by the need for open, structured, and verifiable EV data. Special thanks to all contributors who help maintain and improve this dataset.
---