deviceDefinitionId

A unique identifier for make + model + year

High-Level Explanation

When a new unique combination of year, make, and model is observed from a DIMO vehicle, a unique key is created to enable searching for that year, make, and model combination by one key. For example, 22N2y6fsIukcmReyfsT9Kt8PuN2 is the deviceDefinitionId for all 2017 Tesla Model X vehicles.

Enables

If an analysis requires comparing vehicles of the same year, make, and model, all data with a single deviceDefinitionId could be queried, rather than having to match the three columns of year, make, and model.

Metadata on this vehicle is available at https://device-definitions-api.dimo.zone/device-definitions/{value} where value is the deviceDefinitionId of interest. This can be queried in Python, for the deviceDefinitionId that represents a 2016 Volvo XC90, using the requests library as in

import requests
import json

value = '22N2yHm4Y65PYBs3OIqYKQyykp0'
response = requests.get(f'https://device-definitions-api.dimo.zone/device-definitions/{value}')

metadata_df = pd.json_normalize(json.loads(response.json()['metadata']))

This response contains data on the vehicle and the various trims, as available. For example, metadata_df contains information such as the type of powertrain, fuel tank capacity, miles per gallon, etc.

Enabled By

A unique value is generated randomly upon a new unique combinations of year, make, and model.