RitAssist


The ritassist device tracker platform allows you to integrate your vehicles equipped with RitAssist or FleetGO hardware into Home Assistant. It allows you to see certain details about your vehicle, but also shows your vehicle on the map.

Setup

To use this component, you need an API key and API secret, which can be requested by contacting info@fleetgo.com.

Configuration

To use this device tracker in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: ritassist
    client_id: YOUR_CLIENT_ID
    client_secret: YOUR_CLIENT_SECRET
    username: YOUR_RITASSIST_USERNAME
    password: YOUR_RITASSIST_PASSWORD
    include:
        - LICENSE_PLATE

Configuration Variables

client_id

(string)(Required)The client ID used to connect to the RitAssist API.

client_secret

(string)(Required)The client secret used to connect to the RitAssist API.

username

(string)(Required)Your RitAssist username.

password

(string)(Required)Your RitAssist password.

include

(strings)(Optional)A list of license plates to include, if this is not specified, all vehicles will be added.

See the device tracker component page for instructions on how to configure the people to be tracked.

Available attributes

Attribute Description
latitude The latitude of your vehicle
longitude The longitude of your vehicle
altitude Altitude of your vehicle
id Identifier used to identify your vehicle
make The make of the vehicle
model Model of your vehicle
license_plate License plate number
active If the engine is currently active or not
odo The odometer in kilometers
speed The current speed of your vehicle, in KM/h
last_seen The date and time when your vehicle last communicated with the API
fuel_level Fuel level of the vehicle [1]
malfunction_light Are any malfunction lights burning [1]
coolant_temperature Temperature of the coolant [1]
power_voltage Power voltage measured by the hardware [1]
distance_from_home How far is your vehicle located from your Home Assistant Home location
current_max_speed The maximum speed on the road the device is currently on (if available)
current_address Object with address information the device is currently on. This resolves to the closest address to the coordinates of the device.

[1] Only available on certain cars and hardware revisions.