In my opinion, the instructions are not clear on how to use the device_tracker.see service in Home Assistant. I hope that this explanation helps people out.
I will go thru how to create a device_tracker with the service, attach it to a person, and use it to manipulate the person’s zone manually and predictably for testing.
This is useful for troubleshooting zone related automations, scripts, templates, and blueprints such as my blueprint here.
Start off by going into developer - services and opening up device_tracker.see service.
In UI mode add a new Device ID and set it’s location to home. Click call service button bottom right. I called mine aaatest, but use whatever name you like.
Open a new window to developer - states and look at the entity you just made, device_tracker.aaatest
.
Now open up your People integration and select a person to use for testing. Alternatively you could create a new person for temporary use if desired.
Remember the track device(s) listed so that you can put them back un later, then remove any(all) existing tracking devices. Add the aaatest device tracker.
NOTE: It is possible to leave the Persons device trackers there and add a new one, but if that tracker you didn’t remove changes state, it will update the Person and might cause confusion. Therefore I recommend removing trackers that you do not control for testing so that only the tracker that you do control is changing the person’s state. The person’s state will update to match the location of the last tracker that reports in.
Now you have a person set to a manual device tracker. By changing the location in developer - services you can see it change in developer - states and the person you picked will move to the new location. Use this to test people moving from home, to not home, to any of the zones you have set-up in your HA instance.
When you are all done, restore the track devices that were in the person’s set-up before you changed them and delete the aaatest device tracker to bring your config back to normal.