Server Data Dto Reference

The ThingsTelemetry\Traccar\Dto\ServerData represents the Traccar server configuration and system metadata. This class provides typed access to server attributes, map preferences, storage information, and other settings.

use ThingsTelemetry\Traccar\Facades\Server;

$info = Server::get();

id → integer

Traccar server entity identifier.

$id = $info->id; // 1

attributes → ServerAttributesData

Typed server attributes & preferences (units, timezones, UI flags). Instance of ThingsTelemetry\Traccar\Dto\ServerAttributesData

$attributes = $info->attributes; // instance of ServerAttributesData

IMPORTANT

Please see Server Attributes Data for more details.

registration → boolean

Whether new user registration is enabled on Traccar server.

$info->registration; // true

readonly → boolean

If true, server configuration changes are read-only.

$info->readonly; // false

deviceReadonly → boolean

Whether devices themselves are read-only (cannot be edited).

$info->deviceReadonly; // true

map → Map

Traccar map provider (enum). Instance of ThingsTelemetry\Traccar\Enums\Map

$info->map->value;   // "osm"
$info->map->label(); // "OpenStreetMap"

bingKey → string|null

Bing Maps API key (if configured).

$info->bingKey; // null or "BING_API_KEY"

mapUrl → string|null

Custom tile base URL for maps (if set).

$info->mapUrl; // "https://tiles.example.com/{z}/{x}/{y}.png"

overlayUrl → string|null

Optional overlay tiles URL for extra map layers.

$info->overlayUrl; // "https://overlays.example.com/{z}/{x}/{y}.png"

latitude → float

Default map center latitude.

$info->latitude; // -1.2921

longitude → float

Default map center longitude.

$info->longitude; // 36.8219

zoom → integer

Default map zoom level.

$info->zoom; // 10

forceSettings → boolean

If true, clients must use server-provided settings.

$info->forceSettings; // true

coordinateFormat → CoordinateFormat

Preferred coordinate display format (enum). Instance of ThingsTelemetry\Traccar\Enums\CoordinateFormat

$info->coordinateFormat->value;   // "dd"
$info->coordinateFormat->label(); // "Decimal Degrees"

limitCommands → boolean

Whether command execution is limited by server policies/permissions.

$info->limitCommands; // false

disableReports → boolean

If true, reporting features are disabled on Traccar server.

$info->disableReports; // false

fixedEmail → boolean

If true, user email is fixed and cannot be changed.

$info->fixedEmail; // true

poiLayer → string|null

Points-of-interest layer identifier or URL (if any).

$info->poiLayer; // "poi-layer" or null

announcement → string|null

Global announcement text to show to users.

$info->announcement; // "System maintenance on Sunday."

emailEnabled → boolean

Whether email notifications/features are enabled.

$info->emailEnabled; // true

geocoderEnabled → boolean

Whether reverse geocoding (address lookup) is enabled.

$info->geocoderEnabled; // true

textEnabled → boolean

Whether text/SMS notifications are enabled.

$info->textEnabled; // false

storageSpace → StorageInfo|null

Instance of ThingsTelemetry\Traccar\Support\StorageInfo class or null if the user lacks permissions or the server doesn't return it.

if ($info->storageSpace) {
    $info->storageSpace->formatted();
}
// [
//   [
//      'free' => '9.23 GB',
//      'total' => '58.93 GB',
//      'used' => '49.7 GB',
//      'free_percent' => '15.73%'
//   ],
// ]

newServer → boolean

Indicates if the server is a fresh installation. Defaults to false if not provided by the server.

$info->newServer; // false

openIdEnabled → boolean

Whether OpenID authentication is enabled.

$info->openIdEnabled; // true

openIdForce → boolean

If true, OpenID auth is enforced for sign-in.

$info->openIdForce; // false

version → string

Traccar server version string.

$info->version; // "6.10.0"