home-assistant.io/source/_components/mqtt_json.markdown
Franck Nijhof ebca3218c7
🔥Removes linkable_title everywhere (#9772)
* Automatically create linkable headers

* Visually improve position of linkable header chain icon

* Do not auto link  headers on homepage

* Remove linkable_title everywhere

* 🚑 Re-instante linkable_title plugin as NOOP
2019-07-04 19:08:27 +02:00

1.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_iot_class, ha_release, redirect_from
layout title description date sidebar comments sharing footer logo ha_category ha_iot_class ha_release redirect_from
page JSON MQTT Device Tracker Instructions on how to use JSON MQTT to track devices in Home Assistant. 2017-04-12 20:41 true false true true mqtt.png
Presence Detection
Configurable 0.44
/components/device_tracker.mqtt_json/

The mqtt_json device tracker platform allows you to detect presence by monitoring an MQTT topic for new locations. To use this platform, you specify a unique topic for each device.

Configuration

To use this device tracker in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: mqtt_json
    devices:
      paulus_oneplus: location/paulus
      annetherese_n4: location/annetherese

{% configuration %} devices: description: List of devices with their topic. required: true type: list qos: description: The QoS level of the topic. required: false type: string {% endconfiguration %}

Usage

This platform receives JSON formatted payloads containing GPS information, for example:

{"longitude": 1.0,"gps_accuracy": 60,"latitude": 2.0,"battery_level": 99.9}

Where longitude is the longitude, latitude is the latitude, gps_accuracy is the accuracy in meters, battery_level is the current battery level of the device sending the update. longitude and latitude are required keys, gps_accuracy and battery_level are optional.