The Geotab feed type in ArcGIS Velocity periodically polls a Geotab database for real-time automatic vehicle location (AVL) data by sending an HTTP request to a specified URL. For more information about Geotab, see About Geotab in the Geotab documentation.
- A city wants to monitor their fleet of snowplow trucks during the winter season. The Geotab feed is used to observe the real-time location of each truck and gather other ancillary information such as whether the plow blade is engaged or if the bin storing deicing salt is at a low threshold.
- A waste management company wants to improve the efficiency of their fleet through data-driven analysis. The Geotab feed is used to collect each vehicle's location, load weight, idle time, and fuel level in real time.
- The Geotab feed constructs events using the data from tables in the Geotab database. For example, location, speed, and bearing attributes are retrieved from the DeviceStatusInfo table. The Device table is used to retrieve additional attribute information such as the VIN, vehicle license plate, and so on. Group names and group IDs associated with each device are obtained from the Group table. See the Schema section below for additional information.
- The data from Geotab is highly normalized and, the Geotab feed follows a fixed schema by default. The Geotab feed automatically sets the location, date and time, and Track ID. The Track ID field can be changed.
- Optional diagnostic IDs can be provided to enhance the schema with additional attribute values. For example, if a vehicle is equipped with a sensor to monitor total fuel usage, providing the DiagnosticDeviceTotalFuelId diagnostic ID causes the feed to collect this specific information in a new attribute field. Diagnostic fields are reflected in the feed schema.
- One or more optional groups can be specified to limit the type of device data that is retrieved from the Geotab feed.
- The recommended interval to poll for Geotab data is every 30 seconds or greater. For more information, see Rate Limits in the Geotab documentation.
The URL used to authenticate with Geotab. The URL commonly takes the form of https://[myserver].geotab.com/apiv1.
The name of the Geotab database.
The user name for authenticating Geotab.
The password for authenticating Geotab.
Optional group names used to filter for entity members. For example, street sweeping vehicles may belong to a group named Sweepers. Only vehicles that are entity members of the Sweepers group will be retrieved for real-time processing.
Specify multiple groups using a semicolon (;).
Diagnostic IDs (optional)
Optional diagnostic IDs used to obtain diagnostic values. For example, DiagnosticDeviceTotalFuelId is the diagnostic ID used to retrieve total fuel consumption from vehicles equipped with the correct sensor.
A diagnostic value field and a diagnostic time stamp field are added for each diagnostic ID.
Specify multiple diagnostic IDs using a semicolon (;).
Considerations and limitations
- At each polling interval, Geotab provides the data it compiled at the last poll; data compiled after that poll is not included. Provided data may be older than the time stamp of the last poll made by the feed.
- Diagnostic values update at a rate different than other device data. For this reason, each diagnostic field is accompanied by a time stamp field. Consider whether diagnostic values are temporally relevant to the latest time stamp of the other data retrieved from Geotab.
- When specifying unique diagnostic IDs, you can use groups to filter the type of devices coming from Geotab first. Each diagnostic ID enhances the schema for all the vehicles from Geotab. For example, a diagnostic that captures the status of a snowplow blade will be appended to all vehicle types from Geotab, not only the snowplow trucks. The diagnostic value will be null for vehicles without the sensor. If a snowplow group is defined first, only snowplow trucks will be retrieved from Geotab and have the custom diagnostic field for the relevant snowplow blade status.