developers.home-assistant/blog/2024-09-24-device-tracker-entity-description.md
epenet a52c2ab912
Adjust device tracker documentation (#2335)
* Adjust device tracker documentation

* Adjust defaults

* Add link

* Simplify text

* Rename
2024-09-25 15:13:46 +02:00

26 lines
1.2 KiB
Markdown

---
author: epenet
authorURL: https://github.com/epenet
title: "Enforce SourceType and add shorthand attributes and EntityDescription to device_tracker"
---
The `source_type` property of device_tracker entities is now always expected to be a `SourceType` enum value. Standard strings are no longer valid.
`TrackerEntity` and `ScannerEntity` now have a dedicated `ScannerEntityDescription` and `TrackerEntityDescription`, which need to be used as base class when associating an `EntityDescription` to the `Entity`.
The `source_type` for these entities now also defaults to `SourceType.GPS` and `SourceType.ROUTER`, and it may be possible to drop the overriding property.
The following shorthand attributes have also been added:
- `BaseTrackerEntity._attr_source_type`
- `TrackerEntity._attr_latitude`
- `TrackerEntity._attr_location_accuracy`
- `TrackerEntity._attr_location_name`
- `TrackerEntity._attr_longitude`
- `TrackerEntity._attr_source_type` (defaults to `SourceType.GPS`)
- `ScannerEntity._attr_hostname`
- `ScannerEntity._attr_ip_address`
- `ScannerEntity._attr_mac_address`
- `ScannerEntity._attr_source_type` (defaults to `SourceType.ROUTER`)
More details can be found in the [device-tracker documentation](/docs/core/entity/device-tracker).