a driver-facing app for owner-operators and small fleets. Geotab is one of the ELD providers my users already run, and I want the app to read their data with their permission so they never type anything twice.
I've registered a demo database, Demo_runninonmt_v2, and read it through the API. Four questions the data couldn't answer:
1. Authorization. Your SystemSettings lists allowedUserAuthenticationType: "BasicAuthentication, SAML". When the customer is a one-truck owner-operator who owns his own database, is there an OAuth or delegated-access flow a third-party app should use? Or is the expected pattern a dedicated service-account user whose credentials the customer shares with us? If it's the service account, what's the narrowest security clearance that can still read Device, Trip, LogRecord, FuelTransaction, FuelTaxDetail and DutyStatusLog?
2. Distance units. Your speedingTrigger values (113, 129, 145) tell me API speeds are km/h even when the user's display is imperial. Is Trip.distance always kilometres too, whatever the user's isMetric setting is? Every trip in the demo reads 0, so I can't confirm it from the data.
3. FuelTaxDetail. The type name is accepted but comes back empty, and the demo shows enableFuelProcessing: false. What does a FuelTaxDetail row carry? Is it distance split by jurisdiction? Is that distance taken from GPS position or from engine odometer? I need to tell the driver which one his number came from.
4. A US heavy-truck demo dataset. The "Vehicle with tachograph" option produced a European fleet, and the "Passenger" option produced Corollas with synthetic trips. Is there a demo configuration that gives US heavy trucks with real trip distances, fuel transactions and duty-status logs?
Finally, is there an Integration or Marketplace Partner track for an app like this? I'd rather start on the right track than move onto it later.
Thank you