Device Attributes Data Dto Reference

The ThingsTelemetry\Traccar\Dto\DeviceAttributesData represents additional, device-specific attributes provided by Traccar. These can control reporting behavior, visuals, thresholds, and forwarding.

use ThingsTelemetry\Traccar\Facades\Device;

// ThingsTelemetry\Traccar\Dto\DeviceAttributesData;
$attributes = Device::all()->first()->attributes

speedLimit → float|null

Maximum speed threshold for the device.

$attributes->speedLimit; // 80.0

WARNING

The speedLimit value is always stored in knots in Traccar, even if the server is configured to use other units. That's the default units all GPS modules use. Ref 1 Ref 2 Ref 3

fuelDropThreshold → float|null

Threshold for detecting a fuel drop event.

$attributes->fuelDropThreshold; // 5.0

fuelIncreaseThreshold → float|null

Threshold for detecting a fuel increase/refueling event.

$attributes->fuelIncreaseThreshold; // 8.5

reportIgnoreOdometer → boolean|null

If true, odometer value is ignored in reports for this device.

$attributes->reportIgnoreOdometer; // false

deviceInactivityStart → float|null

Start time (minutes) before considering device inactive.

$attributes->deviceInactivityStart; // 30

deviceInactivityPeriod → float|null

Length of inactivity period (minutes) after start threshold.

$attributes->deviceInactivityPeriod; // 60

notificationTokens → string|null

Comma-separated push notification tokens for this device.

$attributes->notificationTokens; // "TOKEN1,TOKEN2"

commandSender → string|null

Sender identifier used for device commands.

$attributes->commandSender; // "system"

webReportColor → string|null

Hex or named color used for device reports in the web UI.

$attributes->webReportColor; // "#FF9900"

devicePassword → string|null

Password for certain device protocols requiring authentication.

$attributes->devicePassword; // "secret"

deviceImage → string|null

URL or asset path for a custom device image.

$attributes->deviceImage; // "https://example.com/images/device.png"

processingCopyAttributes → string|null

Comma-separated attribute keys to be copied during processing.

$attributes->processingCopyAttributes; // "ignition,battery"

decoderTimezone → string|null

Custom timezone for decoding device messages.

$attributes->decoderTimezone; // "UTC"

forwardUrl → string|null

URL to forward device data to an external system.

$attributes->forwardUrl; // "https://webhook.example.com/traccar"

IMPORTANT

Null boolean attributes default to false when interpreted in most application logic. Validate and coalesce as needed.