2025.3.4
首页 ▸ Integrations ▸

Traccar 服务器

Traccar 使用 GPS 进行追踪，并支持超过 1500 种不同类型的设备。您可以使用 Traccar 服务器集成与您自己的 Traccar 服务器 进行通信，该服务器还作为 Home Assistant 附加组件 提供。

Tip

正在寻找有关如何在 Home Assistant 中使用 Webhooks 设置 Traccar 客户端的文档吗？请参见 Traccar 客户端 集成文档。

配置

要将 Traccar 服务器 integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 Traccar 服务器。

  • 按照屏幕上的说明完成设置。

事件

Traccar 服务器集成选项允许您定义要监听的事件列表。这些事件将作为 事件 发送到 Home Assistant。

所有事件都将以 traccar_ 为前缀，后跟事件名称的小写蛇形命名。示例：

  • deviceMoving 将在 Home Assistant 中触发为 traccar_device_moving。
  • geofenceExit 将在 Home Assistant 中触发为 traccar_geofence_exit。
  • alarm 将在 Home Assistant 中触发为 traccar_alarm。

所有事件还将包含以下数据：

设备 ID

(device_traccar_id) 这是与事件相关的设备 ID。

设备名称

(device_name) 这是与事件相关的设备名称。

类型

(type) 这是事件的类型。

服务器时间

(serverTime) 这是 Traccar 服务器接收到事件的时间。

属性

(attributes) 这是与事件相关的属性字典。

示例 
{
    "device_traccar_id": 24,
    "device_name": "我的设备",
    "type": "alarm",
    "serverTime": "1970-01-01T00:00:00.000Z",
    "attributes": {
      "custom_attribute": "value"
    },
}

设备

Traccar 服务器集成将为 Traccar 服务器中每个注册且至少有一个位置更新的设备创建设备。

这些设备在 Home Assistant 中的表示将与 实体 相关联，您可以在 自动化、脚本 中使用，并在您的 仪表板 上显示。

实体

Traccar 服务器集成将在以下域中创建实体：

有关每个实体的更多详细信息，请参阅下面的部分。

二进制传感器 - 运动

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 binary_sensor 实体，以显示 Traccar 服务器报告的运动。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟“运动”一词。如果您的设备命名为“千年隼”，那么它将是“千年隼运动”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 position_attributes_motion。

状态

如果 Traccar 服务器报告设备正在移动，则为 Moving，否则为 Stopped。

此实体没有任何属性。

二进制传感器 - 状态

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 binary_sensor 实体，以显示 Traccar 服务器报告的状态。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟“状态”一词。如果您的设备命名为“千年隼”，那么它将是“千年隼状态”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 device_status。

状态

如果 Traccar 服务器报告设备在线，则为 Online；如果报告设备离线，则为 Offline；如果不确定，则为 Unknown。

此实体没有任何属性。

设备追踪器

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 device tracker 实体。

名称

设备追踪器的名称将设置为您在 Traccar 服务器中命名的名称。

实体 ID

这将是设备追踪器名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID。

状态

作为设备追踪器，状态将为 home 或 not_home。

属性

除了您可以在 Traccar 服务器集成选项中定义的自定义属性外，设备追踪器实体将具有以下属性：

类别

如果定义，则为 Traccar 中设备的类别。

Traccar ID

设备在 Traccar 中的 ID。

追踪器

仅字符串 traccar_server。

传感器 - 地址

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 sensor 实体，以显示 Traccar 服务器报告的地址。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟地址。如果您的设备命名为“千年隼”，那么它将是“千年隼地址”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 position_address。

状态

这将是 Traccar 服务器报告的地址，如果未配置地理检测，则将为 unknown。

此实体没有任何属性。

传感器 - 高度

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 sensor 实体，以显示 Traccar 服务器报告的高度。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟高度。如果您的设备命名为“千年隼”，那么它将是“千年隼高度”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 position_altitude。

状态

这将是以米为单位的高度。如果您想选择不同的单位，可以在实体选项中进行选择。

此实体没有任何属性。

传感器 - 电池

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 sensor 实体，以显示 Traccar 服务器报告的剩余电池百分比。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟电池。如果您的设备命名为“千年隼”，那么它将是“千年隼电池”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 position_attributes.batteryLevel。

状态

这将是受追踪设备报告的电池百分比（电量），如果设备没有电池，则将为 unknown。

此实体没有任何属性。

传感器 - 地理围栏

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 sensor 实体，以显示 Traccar 服务器报告的地理围栏。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟地理围栏。如果您的设备命名为“千年隼”，那么它将是“千年隼地理围栏”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 geofence_geofence。

状态

这将是设备所在的地理围栏，如果您有重叠的地理围栏，则将显示 Traccar 服务器报告的第一个地理围栏。

此实体没有任何属性。

传感器 - 速度

Traccar 服务器集成将为每个在 Traccar 服务器中注册的设备创建一个 sensor 实体，以显示 Traccar 服务器报告的速度。

此实体默认情况下禁用。

名称

传感器的名称将设置为您在 Traccar 服务器中命名的名称，后跟速度。如果您的设备命名为“千年隼”，那么它将是“千年隼速度”。

实体 ID

这将是名称的 slugified 版本。

唯一 ID

这将是 Traccar 服务器中设备追踪器的唯一 ID，后跟 position_speed。

状态

这将是设备的速度，以节为单位。如果您想选择不同的单位，可以在实体选项中进行选择。

此实体没有任何属性。

示例

因此，您设置了集成并拉入了所有设备。现在怎么办？以下是一些您可以使用 Traccar 服务器集成提供的数据进行操作的示例。

自动化

在本部分中，您将找到一些自动化示例，您可以使用这些示例开始使用 Traccar 服务器集成。

当设备进入地理围栏时执行某些操作

这允许您在设备“千年隼”进入定义的地理围栏时执行某些操作。

给我看看 YAML! 
triggers:
  - trigger: state
    entity_id: sensor.millennium_falcon_geofence
    to: '塔图因'
actions:
  ...

当设备超速时执行某些操作

这允许您在设备“千年隼”超过定义的速度时执行某些操作。

给我看看 YAML! 
triggers:
  - trigger: numeric_state
    entity_id: sensor.millennium_falcon_speed
    above: 1337
actions:
  ...

如果您想在通知中包含速度，可以使用 `` 模板。

部分示例：

triggers:
  ...
actions:
  - action: notify.notify
    data:
      message: "千年隼当前的速度是 !"