Purpose: Use this API to view the idle time or idle events of the drivers in your fleet.

require 'uri'
require 'net/http'

url = URI('https://api.gomotive.com/v1/idle_events')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request['Authorization'] = "Bearer <OAUTH_TOKEN>"

response = http.request(request)
puts response.read_body

Response Parameters

idle_event

• Type: Object
• Description: Details of an idle event for a specific vehicle.

id

• Type: Integer
• Description: Unique identifier for the idle event (e.g., 35040).

start_time

• Type: String (Date-Time)
• Description: The start time of the idle event in ISO 8601 format (e.g., "2018-05-29T09:53:57Z").

end_time

• Type: String (Date-Time)
• Description: The end time of the idle event in ISO 8601 format (e.g., "2018-05-29T09:58:10Z").

veh_fuel_start

• Type: String
• Description: The vehicle's fuel level at the start of the idle event (e.g., 323326.5 liters).

veh_fuel_end

• Type: String
• Description: The vehicle's fuel level at the end of the idle event (e.g., 323326.8091 liters).

lat

• Type: String
• Description: Latitude coordinate of the vehicle during the idle event (e.g., 42.9744623).

lon

• Type: String
• Description: Longitude coordinate of the vehicle during the idle event (e.g., -78.9293763).

city

• Type: String
• Description: City where the idle event took place (e.g., "Tonawanda").

state

• Type: String
• Description: State where the idle event took place (e.g., "NY").

rg_brg

• Type: String
• Description: Registration bearing during the idle event (e.g., 226.923888332155).

rg_km

• Type: String
• Description: Registration kilometers during the idle event (e.g., 6.4759410773022 km).

rg_match

• Type: Boolean
• Description: Indicates if the registration matches (e.g., true).

end_type

• Type: String
• Description: The reason why the idle event ended (e.g., "vehicle_moving").

driver

• Type: Object
• Description: Information about the driver during the idle event. Null if not applicable.

vehicle

• Type: Object
• Description: Information about the vehicle involved in the idle event.

id

• Type: Integer
• Description: Unique identifier for the vehicle (e.g., 4052).

number

• Type: String
• Description: Vehicle number or identifier (e.g., "F335ca_00795348").

year

• Type: String
• Description: Year of the vehicle's manufacture (if available).

make

• Type: String
• Description: Manufacturer of the vehicle (e.g., "Ford").

model

• Type: String
• Description: Model of the vehicle.

vin

• Type: String
• Description: Vehicle Identification Number (VIN).

metric_units

• Type: Boolean
• Description: Indicates whether metric units are used (e.g., false for imperial units).

eld_device

• Type: Object
• Description: Information about the vehicle gateway associated with the idle event.

id

• Type: Integer
• Description: Unique identifier for the vehicle gateway (e.g., 21186).

identifier

• Type: String
• Description: Identifier for the vehicle gateway (e.g., "00795348").

model

• Type: String
• Description: Model of the vehicle gateway (e.g., "lbb-3.35ca").

location

• Type: String
• Description: Description of the location where the idle event occurred (e.g., "Tonawanda, NY").