Electric Vehicle Reporting and Monitoring
User Guide
0 mins to read
•Guidance on how to interface with various spreader controllers and other in-vehicle sensors commonly installed by Public Works agencies. All integrations require a GO9 installed in the vehicle along with a Spreader Gateway.
! IMPORTANT: The term Electric Vehicle (EV) is used in this Guide to refer to a vehicle that plugs into an electric power source to charge and store electric energy in a vehicle battery. The term includes both plug-in hybrid EVs (PHEV) and battery EV (BEV). The term does not include conventional hybrids because they do not plug into an electric power source.
! IMPORTANT: To determine which EVs receive support, visit the EV Make/Model Support Reference.
Do you have a use case/feature request for your EVs?
The EV Product Management Team wants to hear from you! We work hard to improve our products and your feedback is important to us. Please contact your Reseller.
While some reports are currently available, others are only available in Feature Preview. Telematics Device firmware, needed to access vehicle data and populate reports, may not yet be available for all data sets and EV makes/models.
The table below provides information about which Telematics Device service plan is required for EV data to populate the reports. For example, while the Fuel and EV Energy Usage report is available for all Telematics Device service plans, different report fields are visible depending on the service plan. The report fields for Fuel Used and Fuel Economy are visible on the Pro service plan or above but the Electric Energy Used and Electric Energy Economy are visible on the Pro and ProPlus service plan.
Map — EV Charging Activity | ||||||
EV Data | Telematics Device Version 7/8 | Telematics Device Version 9 | Service Plan | Fleet Management Application | ||
Real-time charging status | ✔ | Support on confirmed models. | ✔ | Support on confirmed models. | Pro/ProPlus | Feature Preview |
Real-time battery charge % (SOC) during driving and charging | ✔ | Support on confirmed models. | ✔ | Support on confirmed models. | Pro/ProPlus | Feature Preview |
Engine Measurements & Exception Rules — EV Data Diagnostics | ||||||
EV Data | Telematics Device Version 7/8 | Telematics Device Version 9 | Service Plan | Fleet Management Application | ||
EV driving energy (see EV Data Diagnostic Guide for specific data diagnostics) | ✔ | Support on confirmed models. | ✔ | Support on confirmed models. | Pro/ProPlus | Available |
EV charging AC and DC energy (see EV Data Diagnostic Guide for specific data diagnostics) | ✘ | Not supported. No planned future support. | ✔ | Support on confirmed models. | Pro/ProPlus | Feature Preview |
Charging status and battery charge % (SOC) | See: Map — EV Charging Activity for availability information | See: Map — EV Charging Activity for availability information | Pro/ProPlus | Feature Preview | ||
Reports — Fuel and EV Energy Usage Report | ||||||
EV Data | Telematics Device Version 7/8 | Telematics Device Version 9 | Service Plan | Fleet Management Application | ||
EV driving energy | ✔ | Support on confirmed models. | ✔ | Support on confirmed models. | Pro/ProPlus | Available |
Reports — EV Charging Report | ||||||
EV Data | Telematics Device Version 7/8 | Telematics Device Version 9 | Service Plan | Fleet Management Application | ||
EV charging energy | ✘ | Basic support on confirmed models. Not supported: energy, power, current type, AC voltage | ✔ | Support on confirmed models. | Pro/ProPlus | Feature Preview |
➤ KEY INFO: Locating Your Firmware Version and Device Version
! IMPORTANT: To determine which EVs receive support, visit the EV Make/Model Support Reference.
The Built-In Exception Rules are in Beta and not currently enabled by default. To access this feature, you must enable Feature Preview.
To enable Feature Preview, follow the steps below.
1 | Navigate to Administration > Users from the main menu. |
2 | Search for your name and in the User Edit page, click the UI Settings tab. |
3 | For Feature Preview, toggle the button to On. |
4 | Click Save. |
✱ NOTE: Features that are in preview may change, break or disappear at any time. Using these features in a production setting is not recommended.
For supported EVs, the live Map now displays the current battery charge % and indicates whether the vehicle is charging, driving, or stopped.
Key Questions | Answers |
Know What’s Happening in Real-Time Who needs to charge? Who is actively charging? Who has the most / least battery charge %? | Map Live Positions: Allows you to see actively charging EVs. Allows you to see the real-time charge % for EVs. |
Which vehicle is closest to a location, and within sufficient range? | Map Live Positions — Nearest: Allows you to see and filter EV Charge — Real-time charge % (SOC). |
The Map view allows you to see which EVs are charging, outside or inside a zone.
The List view allows you to see which EVs are charging, as well as the driving charge % for each EV, updated at 1% increments. The List view also allows you to sort the vehicles by battery charge % (EV Charge).
The Nearest View helps you find the vehicles closest to your current location, and helps you assess which vehicle has enough range for a trip based on viewing their battery charge %.
With EV data diagnostics, Engine Measurements allows for more advanced reporting that is not supported by the reports and features outlined above.
To access Engine Measurements, select Engine & Maintenance > Engine and Device … > Measurements from the main navigation menu.
For more detailed information on EV data diagnostics and their availability, visit the Electric Vehicle Data Diagnostics User Guide.
✱ NOTE: For more on Exceptions, visit the section titled Exceptions in the Product Guide. |
Within the Sustainability section, you will find four built-in rules for your EVs, currently under Feature Preview. To enable Feature Preview, see Fleet Management Application: Enabling Feature Preview.
Get notified when an EV becomes at risk of not having sufficient charge to complete routes without stopping to charge, which is a high productivity loss. This rule will trigger when the electric vehicle (EV) battery charge % (State of Charge) drops below the configured value.
Important Information and Tips:
When an EV returns to a lot/depot with sufficiently low charge, it is time to plug in. This rule is useful for plug-in reminders and identifying which EVs need to be prioritized for charging.
Important Information and Tips:
This rule will trigger when EVs exit a charging zone of the specified type(s) while its battery charge is below the configured value. This is useful for identifying EVs that:
Important Information and Tips:
This rule will trigger when the EV battery is charged to the configured value. This is useful to indicate when the EV’s charging plug can be provided to another EV, or when it is important to know when the EV is ready for use.
Important Information and Tips:
With EV data diagnostics, Exception Rules offer support for additional event-based notifications and reporting, outside of those built-in rules. The following are a few to get you started!
✱ NOTE: For more on Exceptions, visit the section titled Exceptions in the Product Guide. |
Key Questions | Answers |
Time to Charge? Who needs to charge? Who needs to charge at a specific location? | Notifications/report for low battery charge % (SOC). Exception Rule Conditions:
|
Time to Unplug? When there are more EVs than plugs, which EVs are done charging and their plug can be given to the next EV? | Notifications/report for 100% battery charge % (SOC). Exception Rule Conditions:
|
Charging during Peak Rate Time? Is there an EV charging when electricity rates are high? | Restrict charging during peak rate periods.
|
The Fuel and EV Energy Usage Report displays driving energy consumption from both fuel and electric energy sources. Driving energy consumption includes both propulsion and auxiliary, such as heating and cooling. Both fuel and electric energy usage are combined in this report to handle Plug-in Hybrid Electric Vehicles (PHEV), which consume both fuel and electric energy.
Key Questions | Answers |
Performance How are my EVs performing? What electric range am I typically getting? Is it close to the promised range? How are my EVs performing in comparison to my fuel cars? | Electric Energy Economy — Reports on performance for BEVs. Total Fuel and Electric Energy Economy — Reports on efficiency for PHEVs, and provides a comparable value in a mixed fleet. |
Maximizing Use of PHEV Battery Are we maximizing the battery use? Are these just running on gas? | % Electric Energy of Total — Filtering on just PHEVs. |
Below is a simplified list of EV-relevant fields in this report.
Field | Description |
Distance | Total distance travelled on all energy sources. |
Electric Energy Used | Total electric energy used, expressed in either kilowatt hour (kWh) or watt hour (Wh). Wh is used when Electric Energy Economy Measurement unit is set to Wh/km or Wh/mile; otherwise kWh is used. NOTE: Energy added to the battery from all non-charging sources — regenerative braking, driving down a hill, fuel engine charging in a hybrid — is subtracted from Electric Energy Used. If energy is added to the battery faster than it is consumed, the value will be negative. |
Fuel Economy | This is displayed when the vehicle travels exclusively on fuel (electric energy used = 0); otherwise the field remains blank. |
Electric Energy Economy | This is displayed when the vehicle travels exclusively on electric energy (fuel used = 0); otherwise the field remains blank. It is a primary indicator of vehicle electric energy efficiency and performance. NOTE: See Electric Energy Economy Measurement to change the measurement unit. Similar to Electric Energy Used, if energy is added to the battery faster than it is consumed, the value will be negative. |
Total Fuel and Electric Energy Economy | This is a single comparable value across all your vehicles and displayed for every vehicle. If electric energy is used, it is converted to the equivalent in fuel. This converted value is then added to the Fuel Used to calculate this combined Economy value. If electric energy is not used, this value is the same as Fuel Economy. Units = The equivalent of the selected fuel economy measurement. To learn how we convert electric energy to fuel, please refer to the note below. NOTE: Similar to Electric Energy Used, if energy is added to the battery faster than it is consumed, the value will be negative. |
% Electric Energy of Total | Calculation of electric energy used (%), based on all electric and fuel energy usage. To learn how we convert electric energy to fuel, please refer to the note below. NOTE: When Electric Energy Used is negative, this value may exceed 100%. |
How do we convert electric energy to the equivalent in fuel?
Both electricity and fuel are forms of energy. This report performs a conversion of electric energy to the equivalent in fuel to calculate the Total Fuel and Electric Energy Economy, and the % of Electric Energy of Total. For Battery Electric Vehicles (BEV), the equivalent in gasoline fuel is converted. For PHEV, the units convert to the same fuel type that’s used by the vehicle when the fuel type is reliably available.
The United States Environmental Protection Agency (EPA) and the United States Department of Transportation (DOT) have adopted the standard conversion and states that 1 US Gallon of Gasoline is equivalent to 33.7 kWh of electric energy (src). Additionally, the United States Department of Energy Alternative Fuels Data Center defines 1 US Gallon of Diesel as having 113% of the energy of 1 US Gallon of Gasoline (src).
Using these baseline conversions, including standard volume conversions to Liters and Imperial Gallons, we can convert electric energy to the equivalent in fuel.
Similar to Fuel Economy Measurement, the Electric Energy Economy Measurement allows users to display measurements in the desired units.
To change the measurement unit, follow the steps below:
1 | In the Fleet Management Application, click the user name in the top right corner of the screen and select Options. |
2 | Under the Main Settings tab, choose the desired measurement unit located next to Electric Energy Economy Measurement. |
3 | Click Save. |
✱ NOTE: The “-e” attached to L and MPG indicates that the unit converts electric energy to the equivalent in either liters or gallons of fuel. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline.
Electric Energy Economy Measurement: Metric | |
Unit | Description |
L-e/100 km | The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is L/100 km. NOTE: This converts electric energy into the fuel equivalent (in litres) to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done. |
km/L-e | The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is km/L. NOTE: This converts electric energy into the fuel equivalent (in litres) to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done. |
kWh/100 km Wh/km | For a primarily EV fleet, this helps you understand how much energy is used / needed for a specified distance. |
km/kWh | For a primarily EV fleet, this helps you understand how much distance you can cover based on the battery energy — measured in kWh. |
Electric Energy Economy Measurement: US/Imperial | |
Unit | Description |
MPG-e (US) MPG-e (Imp) | The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is MPG. NOTE: This converts electric energy into gallons equivalent of fuel to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done. |
kWh/100 miles Wh/mile | For a primarily EV fleet, this helps you understand how much energy is used / needed for a specified distance. |
mile/kWh | For a primarily EV fleet, this helps you understand how much distance you can cover based on the battery energy — measured in kWh. |
✱ NOTE: Electric Energy Economy is currently based on distance. In some cases, EVs operate in a stationary position for long periods of time, and idle. In these cases, it’s better to calculate Electric Energy Economy over time rather than distance, such as kWh/hour. Use the Electric Energy Used value and report time period to calculate this value.
The Fuel and EV Energy Usage page displays the electric energy and fuel usage by vehicle. Similar to Fuel used, the value for Electric Energy used is displayed under the corresponding vehicle. The list view also displays Total Fuel and Electric Energy Economy for each vehicle, as described in Report Fields — EV Specific Meanings above. When both fuel and EV energy are used, clicking on a row gives you the choice to either view the Fill-Ups or EV Charging Report.
Includes all fields listed in Report Fields — EV Specific Meanings, except for % Electric Energy of Total.
Includes all fields listed in Report Fields — EV Specific Meanings.
The EV Charging Beta Report is the EV equivalent of the Fill-Ups Report used for fuel. This report provides information about the electric power and energy consumed when vehicles plug in to charge.
✱ NOTE: What’s the difference between electric power and electric energy? Power, expressed in kilowatts (kW) or watts (W), is the rate at which electric energy is transferred into the vehicle for charging. The lower the power value, the longer the vehicle takes to charge. Energy, expressed in kilowatt hours (kWh) or watt hours (Wh), is the total volume of power transferred or used over an hour. |
Key Questions | Answers |
Have the Full Charging History What happened? Where, when, for how long and how much did EVs charge? Why do my EVs have the battery charge % that they have? | Answered generally by EV Charging. |
EVs and Building Load What is the EV contribution to facility load? | Sum total Energy Added by Zone. |
✱ NOTE: Trying to calculate charging costs and demand charge/peak charges?
The EV Charging Beta Report does not easily support these uses. The EV Product Management team is aware these are high priority requests and is keen to track more requests. Please contact your Reseller to share your feature requests.
! IMPORTANT: The report fields are populated differently for the following sections in the List, Report, and Advanced report views: start and end dates, duration, and the start and end battery charge %.
Charge Event — Report Tab of Report & Advanced
A Charge Event is recorded from when charging starts (power > 0 W) to when it stops (power = 0 W). During a single stop, there may be multiple Charge Events, if a managed charging, power sharing technology, or manual plug sharing is employed. In this report, each row of data corresponds to a single Charge Event.
Charge Session — List and Summary Tab of Report & Advanced
A Charge Session groups all Charge Events that occur during a single stop. In this report, each row of data corresponds to a single Charge Session. This is intended as a more readable format — especially when managed charging, power sharing or plug sharing is employed.
Field | Description |
Start Date | In the Report and Advanced report Report tab, this is the date and start time of the Charge event. In the List, and Report & Advanced Summary tab, this is the date and start time of the Charge Session — the start of the first charge event during a single stop. |
End Date | In the Report and Advanced report Report tab, this is the date and end time of the Charge Event. In the List, and Report & Advanced Summary tab, this is the date and end time of the Charge Session — the end of last charge event during a single stop. |
Location | The street address of the charging location. When Privacy Mode is applied, this will be blank. |
Zones | If the location is within one or more Zones, the names of the Zones are displayed. When Privacy Mode is applied, this will be blank. |
Zone Types | If any Zone has one or more Types, the name of each Zone Type is displayed. When Privacy Mode is applied, this will be blank. |
Start Charge % | In the Report and Advanced report Report tab, this is the battery charge % remaining at the start of the Charge Event. In the List, and Report & Advanced Summary tab, this is the battery charge % remaining at the start of the Charge Session — the start of the first charge event during a single stop. |
End Charge % | In the Report and Advanced report Report tab, this is the battery charge % remaining at the end of the Charge Event. In the List, and Report & Advanced Summary tab, this is the battery charge % remaining at the end of the Charge Session — the end of the last charge event during a single stop. |
Energy Added | The total electric energy added, expressed in either kilowatt hour (kWh) or watt hour (Wh). Wh is used when Electric Energy Economy Measurement unit is chosen as Wh/km or Wh/mile; otherwise kWh is used. |
Max Power | During a Charge Event or Charge Session, the power typically fluctuates. The maximum value is the best indicator of the sustained power found throughout. The maximum value is also the best indicator of the EV contribution to additional billing charges resulting from excessive power demand, and for being aware of the capacity requirements for EV charging. Wh is used when Electric Energy Economy Measurement unit is chosen as Wh/km or Wh/mile; otherwise kWh is used. |
Current | This is either AC (Alternating Current) or DC (Direct Current). If you want both at once, check out the band by that name, AC/DC. |
AC Voltage | The Alternating Current voltage. |
Electric Energy Economy | The equivalent concept to Fuel Economy in the Fill-Ups Report. This is the amount of energy consumed over the total distance traveled since the end of the previous Charge Event / Charge Session to this one. See Electric Energy Economy Measurement to change the measurement unit. This is not populated for PHEVs if fuel was consumed within the report’s time period. |
✱ NOTE: For those in North America who want to display charging as SAE Level 1 (120 V AC), SAE Level 2 (~240 V AC), or SAE Level 3 (DC), use the Current and AC Voltage values to extend the report. |
The List View displays the following information:
The icon allows you to view the charging location of the vehicle on the Map.
✱ NOTE: Our priority is to provide high accuracy data on all EV makes and models. However, data for some vehicles may be missing or originate from a secondary source, when a primary higher quality source was not available. For these vehicles, the List Limited indicator describes the missing data and specifies if data is obtained from a secondary source, which may result in lower accuracy.
The Report view includes all the fields listed in Report Fields, except for Current and AC Voltage.
The Advanced view includes all fields listed in Report Fields, as well as the Charging Summary by Vehicle and Charging Summary by Zone summarized data reports.