트랙카(Traccar)


Traccar는 추적시 GPS를 사용하며 1500 가지가 넘는 다양한 유형의 장치를 지원합니다. 하나의 옵션은 webhook을 통해 스마트폰에서 Traccar Client 앱을 추적하는 것입니다. 다른 옵션은 Hass.io addon으로도 제공되는 기존 Traccar Server 설치에 연결하는 것입니다.

Traccar 클라이언트

Traccar 클라이언트를 설정하려면 설정 화면의 통합구성요소 패널을 통해 Traccar 클라이언트를 설정해야합니다. 그러면 모바일 장치 설정 중에 사용할 웹 후크 URL이 제공됩니다. 이 URL은 Traccar 앱에서 설정해야합니다.

Traccar 서버

홈어시스턴트에 Traccar 서버를 연동하려면 configuration.yaml 파일에 다음 섹션을 추가하십시오.

# Example configuration.yaml entry
device_tracker:
  - platform: traccar
    host: IP_ADDRESS
    username: USERNAME
    password: PASSWORD

Configuration Variables

host

(string)(Required)

The DNS name or IP Address of the server running Traccar.

username

(string)(Required)

The username for the Traccar server.

password

(string)(Required)

The password for your given account on the Traccar server.

port

(integer)(Optional)

The port of your Traccar server.

Default value:

8082

ssl

(boolean)(Optional)

Use HTTPS to connect to Traccar server. NOTE A host cannot be an IP address when this option is enabled.

Default value:

false

verify_ssl

(boolean)(Optional)

Verify the certification of the system.

Default value:

true

max_accuracy

(integer)(Optional)

Filter positions with higher accuracy than specified.

Default value:

0

skip_accuracy_filter_on

(list)(Optional)

Skip filter position by “max_accuracy filter” if any of specified attributes are pressent on the traccar message.

monitored_conditions

(list)(Optional)

Additional traccar computed attributes or device-related attributes to include in the scan.

event

(list)(Optional)

Traccar events to include in the scan and fire within Home Assistant. NOTE For more info regarding Traccar events please refer to Traccar’s documentation: https://www.traccar.org/documentation/events/.

device_moving

(string)(Optional)

deviceMoving event.

command_result

(string)(Optional)

commandResult event.

device_fuel_drop

(string)(Optional)

deviceFuelDrop event.

geofence_enter

(string)(Optional)

geofenceEnter event.

device_offline

(string)(Optional)

deviceOffline event.

driver_changed

(string)(Optional)

driverChanged event.

geofence_exit

(string)(Optional)

geofenceExit event.

device_overspeed

(string)(Optional)

deviceOverspeed event.

device_online

(string)(Optional)

deviceOnline event.

device_stopped

(string)(Optional)

deviceStopped event

maintenance

(string)(Optional)

maintenance event.

alarm

(string)(Optional)

alarm event.

text_message

(string)(Optional)

textMessage event.

device_unknown

(string)(Optional)

deviceUnknown event.

ignition_off

(string)(Optional)

ignitionOff event.

ignition_on

(string)(Optional)

ignitionOff event.

all_events

(string)(Optional)

allEvents catchall for all event types.

monitored_conditions 매개 변수를 사용하면 traccar 플랫폼에서 비표준 속성을 추적하고 홈어시스턴트에서 사용할 수 있습니다. 예를 들어, 비표준 속성 alarm과 사용자 정의 계산 속성 mycomputedattribute의 상태를 모니터링해야하는 경우 설정을 다음과 같이 채우십시오.

device_tracker:
  - platform: traccar
    ...
    monitored_conditions: ['alarm', 'mycomputedattribute']

event 매개 변수를 사용하면 traccar 플랫폼 (https://www.traccar.org/documentation/events/)에서 이벤트를 가져와 홈어시스턴트에서 실행할 수 있습니다. 모니터하고 가져 오는 이벤트 목록을 승인하며 각 이벤트는 소문자 공백없는 문자로 나열해야합니다. 이벤트는 위에 언급된 목록에 정의된 것과 동일한 이벤트 이름으로 시작되며 앞에는 traccar_ 접두사가 붙습니다. 예를 들어, 홈어시스턴트에서 Traccar 이벤트 deviceOverspeeddeviceFuelDrop을 가져와야하는 경우 event 매개 변수를 다음과 같이 채워야합니다. :

device_tracker:
  - platform: traccar
    ...
    event: ['device_overspeed', 'device_fuel_drop']

홈어시스턴트는 플랫폼에서 해당 이벤트를 수신하면 바로 traccar_device_overspeedtraccar_device_fuel_drop 으로 시작됩니다. 참고 모든 이벤트를 가져 오려면 all_events를 지정하십시오.