Real-World Fuel Economy API

Compare real-world vehicle fuel consumption with official NEDC and WLTP figures across thousands of vehicle variants.

原始信息汇总

数据集概述

Real-World Fuel Economy API 是一个提供真实世界车辆燃料消耗数据的API，涵盖数千种汽油、柴油、混合动力及插电式混合动力车型。该API允许用户将官方NEDC/WLTP测试数据与真实驾驶环境下的油耗进行比较，并提供英国MPG和升/100公里两种单位的数据，以及计算的偏差百分比和数据质量指标。

---

核心功能

• 搜索车辆：支持自然语言查询，如“toyota corolla hybrid”、“bmw 320d”或“volkswagen golf 1.4 tsi”。
• 筛选车辆：可按品牌、型号、发动机、燃料类型、重叠车型年份、官方测试标准及最小真实偏差进行筛选。
• 浏览品牌：支持按品牌浏览数据集。
• 数据集统计：提供整体数据集统计信息。
• 操作型查询：支持基于JSON请求体进行搜索操作。

---

API信息

• 基础URL：https://api.medardkonopik.com/consumption
• 请求方式：通过RapidAPI调用需包含X-RapidAPI-Key和X-RapidAPI-Host标准请求头。
• 提供方：由zenAPI创建。
• 分类：交通运输（Transportation）。
• 订阅用户：当前有1位订阅者。

---

主要端点

方法	路径	功能
GET	/v1/search	搜索车辆
GET	/v1/lookup	筛选车辆
GET	/v1/brands/{brand}	浏览特定品牌车辆
GET	/v1/stats	获取数据集统计
POST	/v1/query	操作型查询（使用JSON请求体）

---

常用查询参数

参数	允许值	默认值
fuelType	petrol, diesel, hybrid, mild-hybrid, plugin-hybrid, electric, lpg, hydrogen	所有类型
officialStandard	prefer-wltp, prefer-nedc, wltp-only, nedc-only, any	prefer-wltp
outputUnits	both, l100km, uk_mpg	both
sortBy	relevance, brand, model, realConsumption, officialConsumption, deviation, yearStart	relevance
sortOrder	asc, desc	asc
offset/limit	分页参数；搜索最大25，查询或品牌浏览最大100	0/端点特定
hasRealConsumptionOnly	true/false	true
includeQualityFlags	true/false	true

---

响应格式

搜索和筛选端点返回分页响应，每条记录包含字段如品牌（brand）、型号（model）、发动机（engine）、燃料类型（fuelType）、官方油耗（officialConsumptionL100km）、真实油耗（realConsumptionL100km）以及真实与官方偏差百分比（realVsOfficialConsumptionDeviationPct）。分页信息包含偏移量（offset）、限制（limit）、返回数量（returned）、总匹配数（totalMatched）及是否有更多数据（hasMore）。

• MPG值为英国MPG。
• API提供标准化的升/100公里值及与所选官方数值的百分比对比。
• 正偏差表示真实油耗高于官方数据。

---

数据集覆盖范围

• 该目录主要关注欧洲及英国市场车型，涵盖大量汽油、柴油、混合动力及插电式混合动力变体。
• 可用性因车型和年份而异，记录中的质量标志有助于识别哪些数据值存在。
• 真实油耗受驾驶条件、天气、负载、轮胎及地形等多种因素影响。