{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"ev-range-efficiency"},"result":{"entity_type":"calculator","id":"ev-range-efficiency","calculator_id":"ev-range-efficiency","canonical_url":"https://tttkmbb.com/energy/ev-range-efficiency","name":"EV Range and Efficiency Calculator","title":"EV Range and Efficiency Calculator – Range from Battery Size and Consumption, with Wh/km, kWh/100 km, mi/kWh and MPGe","category":"energy","category_name":"Home Energy & Electrical","tool_name":"calculate_ev_range_and_efficiency","featured_mcp_tool":false,"description":"Converts an electric vehicle's energy consumption between Wh/km, kWh/100 km, Wh/mile, mi/kWh and km/kWh, computes the driving range from the battery capacity and usable share, and reports the EPA MPGe equivalent (33.7 kWh per US gallon of gasoline).","use_when":"You want an EV's range for a given consumption, or need to compare efficiency figures quoted in different units (European kWh/100 km, US mi/kWh or MPGe).","do_not_use_when":"You need charging time (use ev-charging-time) or running-cost comparison with a petrol car (use fuel-vs-ev-cost); real-world consumption varies with speed, temperature and heating by ±30 % or more.","inputs":[{"name":"battery_capacity_kwh","label":"Battery capacity","type":"number","unit":"kWh","required":true,"max":1000,"exclusive_min":0,"description":"Battery capacity in kilowatt-hours (usable capacity if known; otherwise use usable_percent).","example":75},{"name":"efficiency_value","label":"Consumption / efficiency","type":"number","required":true,"max":100000,"exclusive_min":0,"description":"Energy consumption or efficiency figure in the unit given by efficiency_unit (e.g. 160 Wh/km, 16 kWh/100 km, 3.9 mi/kWh).","example":160},{"name":"efficiency_unit","label":"Unit","type":"enum","required":true,"values":[{"value":"wh_per_km","label":"Wh/km","aliases":["wh/km"]},{"value":"kwh_per_100km","label":"kWh/100 km","aliases":["kwh/100km"]},{"value":"wh_per_mile","label":"Wh/mile","aliases":["wh/mi"]},{"value":"mi_per_kwh","label":"miles/kWh","aliases":["mi/kwh","mpkwh"]},{"value":"km_per_kwh","label":"km/kWh","aliases":["km/kwh"]}],"description":"Unit of efficiency_value.","example":"wh_per_km"},{"name":"usable_percent","label":"Usable capacity","type":"number","unit":"%","required":false,"default":100,"min":1,"max":100,"description":"Share of the battery available for driving (e.g. 90–95 % when the nominal capacity includes a buffer, or 60 for a 20–80 % daily window).","example":100}],"outputs":[{"name":"usable_energy_kwh","label":"Usable energy","type":"number","unit":"kWh","decimals":2,"description":"battery_capacity_kwh × usable_percent / 100."},{"name":"range_km","label":"Range","type":"number","unit":"km","decimals":1,"description":"Usable energy / consumption."},{"name":"range_miles","label":"Range (miles)","type":"number","unit":"mi","decimals":1,"description":"range_km / 1.609344."},{"name":"wh_per_km","label":"Consumption (Wh/km)","type":"number","unit":"Wh/km","decimals":1,"description":"Consumption converted to watt-hours per kilometre."},{"name":"kwh_per_100km","label":"Consumption (kWh/100 km)","type":"number","unit":"kWh/100 km","decimals":2,"description":"wh_per_km / 10."},{"name":"wh_per_mile","label":"Consumption (Wh/mile)","type":"number","unit":"Wh/mi","decimals":1,"description":"wh_per_km × 1.609344."},{"name":"mi_per_kwh","label":"Efficiency (mi/kWh)","type":"number","unit":"mi/kWh","decimals":3,"description":"1000 / wh_per_mile."},{"name":"km_per_kwh","label":"Efficiency (km/kWh)","type":"number","unit":"km/kWh","decimals":3,"description":"1000 / wh_per_km."},{"name":"mpge","label":"MPGe","type":"number","unit":"MPGe","decimals":1,"description":"mi_per_kwh × 33.7 (EPA miles per gallon gasoline-equivalent)."}],"input_schema":{"type":"object","properties":{"battery_capacity_kwh":{"description":"Battery capacity in kilowatt-hours (usable capacity if known; otherwise use usable_percent). Unit: kWh.","type":"number","maximum":1000,"exclusiveMinimum":0,"examples":[75],"x-unit":"kWh"},"efficiency_value":{"description":"Energy consumption or efficiency figure in the unit given by efficiency_unit (e.g. 160 Wh/km, 16 kWh/100 km, 3.9 mi/kWh).","type":"number","maximum":100000,"exclusiveMinimum":0,"examples":[160]},"efficiency_unit":{"description":"Unit of efficiency_value.","type":"string","enum":["wh_per_km","kwh_per_100km","wh_per_mile","mi_per_kwh","km_per_kwh"],"examples":["wh_per_km"]},"usable_percent":{"description":"Share of the battery available for driving (e.g. 90–95 % when the nominal capacity includes a buffer, or 60 for a 20–80 % daily window). Unit: %.","type":"number","minimum":1,"maximum":100,"default":100,"examples":[100],"x-unit":"%"}},"additionalProperties":false,"required":["battery_capacity_kwh","efficiency_value","efficiency_unit"]},"output_schema":{"type":"object","properties":{"usable_energy_kwh":{"description":"battery_capacity_kwh × usable_percent / 100. Unit: kWh.","type":"number","x-unit":"kWh"},"range_km":{"description":"Usable energy / consumption. Unit: km.","type":"number","x-unit":"km"},"range_miles":{"description":"range_km / 1.609344. Unit: mi.","type":"number","x-unit":"mi"},"wh_per_km":{"description":"Consumption converted to watt-hours per kilometre. Unit: Wh/km.","type":"number","x-unit":"Wh/km"},"kwh_per_100km":{"description":"wh_per_km / 10. Unit: kWh/100 km.","type":"number","x-unit":"kWh/100 km"},"wh_per_mile":{"description":"wh_per_km × 1.609344. Unit: Wh/mi.","type":"number","x-unit":"Wh/mi"},"mi_per_kwh":{"description":"1000 / wh_per_mile. Unit: mi/kWh.","type":"number","x-unit":"mi/kWh"},"km_per_kwh":{"description":"1000 / wh_per_km. Unit: km/kWh.","type":"number","x-unit":"km/kWh"},"mpge":{"description":"mi_per_kwh × 33.7 (EPA miles per gallon gasoline-equivalent). Unit: MPGe.","type":"number","x-unit":"MPGe"}}},"formula":"wh_per_km = efficiency_value converted (kWh/100 km × 10; Wh/mile / 1.609344; 1000 / (mi/kWh × 1.609344); 1000 / (km/kWh)); usable_energy_kwh = battery_capacity_kwh × usable_percent / 100; range_km = usable_energy_kwh × 1000 / wh_per_km; range_miles = range_km / 1.609344; kwh_per_100km = wh_per_km / 10; wh_per_mile = wh_per_km × 1.609344; mi_per_kwh = 1000 / wh_per_mile; km_per_kwh = 1000 / wh_per_km; mpge = mi_per_kwh × 33.7","method":"Pure unit arithmetic; the EPA defines MPGe with 33.7 kWh as the energy content of one US gallon of gasoline (115,000 BTU). Official WLTP/EPA consumption figures already include charging losses, while dashboard figures usually do not.","sources":[{"name":"U.S. EPA fueleconomy.gov – Electric vehicle label (MPGe, 33.7 kWh per gallon)","url":"https://www.fueleconomy.gov/feg/label/learn-more-electric-label.shtml","type":"government","retrieved_at":"2026-09-24"},{"name":"Wikipedia – Miles per gallon gasoline equivalent","url":"https://en.wikipedia.org/wiki/Miles_per_gallon_gasoline_equivalent","type":"reference","retrieved_at":"2026-09-24"},{"name":"U.S. DOE Alternative Fuels Data Center – Charging Electric Vehicles at Home","url":"https://afdc.energy.gov/fuels/electricity-charging-home","type":"government","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"75 kWh at 160 Wh/km","inputs":{"battery_capacity_kwh":75,"efficiency_value":160,"efficiency_unit":"wh_per_km"},"expected":{"range_km":468.8,"range_miles":291.3,"kwh_per_100km":16,"wh_per_mile":257.5,"mi_per_kwh":3.884,"km_per_kwh":6.25,"mpge":130.9},"url":"https://tttkmbb.com/api/v1/calculate/ev-range-efficiency?battery_capacity_kwh=75&efficiency_value=160&efficiency_unit=wh_per_km"},{"name":"60 kWh at 4 mi/kWh, 90 % usable","inputs":{"battery_capacity_kwh":60,"efficiency_value":4,"efficiency_unit":"mi_per_kwh","usable_percent":90},"expected":{"usable_energy_kwh":54,"range_miles":216,"range_km":347.6,"wh_per_km":155.3,"kwh_per_100km":15.53,"mpge":134.8},"url":"https://tttkmbb.com/api/v1/calculate/ev-range-efficiency?battery_capacity_kwh=60&efficiency_value=4&efficiency_unit=mi_per_kwh&usable_percent=90"}],"faq":[{"q":"What is MPGe?","a":"Miles per gallon gasoline-equivalent: the miles an EV travels on 33.7 kWh, the energy in one US gallon of gasoline. It compares energy efficiency, not cost or emissions."},{"q":"Why is my real range lower than this?","a":"Rated consumption comes from standard test cycles; motorway speed, cold weather, cabin heating and roof loads raise consumption by 20–50 %, and most drivers keep a 10–20 % reserve."},{"q":"Is battery capacity gross or net?","a":"Manufacturers quote gross (nominal) or net (usable) capacity. Enter the usable value with usable_percent = 100, or the gross value with the usable share (typically 90–96 %)."}],"tags":["ev range","wh per km","kwh per 100 km","miles per kwh","mpge","electric car efficiency"],"related":[{"calculator_id":"ev-charging-time","reason":"Time and cost to add the energy for this range."},{"calculator_id":"fuel-vs-ev-cost","reason":"Running cost versus a petrol or diesel car."},{"calculator_id":"fuel-economy","reason":"Convert the combustion-car figures (mpg, L/100 km, km/L)."}],"links":{"html":"https://tttkmbb.com/energy/ev-range-efficiency","markdown":"https://tttkmbb.com/energy/ev-range-efficiency.md","json":"https://tttkmbb.com/energy/ev-range-efficiency.json","api":"https://tttkmbb.com/api/v1/calculate/ev-range-efficiency","schema":"https://tttkmbb.com/api/v1/calculators/ev-range-efficiency","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T03:44:27Z","next_actions":[{"tool":"run_calculator","calculator_id":"ev-range-efficiency","reason":"Run EV Range and Efficiency Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/energy/ev-range-efficiency.md"}}