Fire an event when a navigation entity is selected while driving

[dshokouhi]

Summary

Fixes: #4315 by adding a new event android.navigation_started which only occurs for navigation entities in the driving interface.

which provides the following example event data:

event_type: android.navigation_started
data:
  entity_id: zone.test
  device_id: DEVICE_ID
origin: REMOTE
time_fired: "2024-09-13T23:10:24.304583+00:00"
context:
  id: ID
  parent_id: null
  user_id: USER_ID

Screenshots

Link to pull request in Documentation repository

Documentation: home-assistant/companion.home-assistant#1103

Any other notes

[jpelgrom]

I'm still not sold on this because of the slippery slope of adding this to all clicks with >1 requester as it might be useful to someone, somehow - as discussed in the original issue. What made you change your mind?

[dshokouhi]

Personally speaking I dont think we should add this to all other entities but i do see value in navigating to an entity which I dont think is a frequent action users will take.

[jpelgrom]

This function will directly throw exceptions in case the call wasn't successful which should be caught :)