diff --git a/source/_integrations/bmw_connected_drive.markdown b/source/_integrations/bmw_connected_drive.markdown index c256c7641fa..80c3799b69f 100644 --- a/source/_integrations/bmw_connected_drive.markdown +++ b/source/_integrations/bmw_connected_drive.markdown @@ -7,6 +7,7 @@ ha_category: - Presence Detection - Lock - Sensor + - Notifications ha_release: 0.64 ha_iot_class: Cloud Polling ha_codeowners: @@ -26,6 +27,7 @@ This integration provides the following platforms: - Device tracker: The location of your car. - Lock: Control the lock of your car. - Sensors: Mileage, remaining range, remaining fuel, charging time remaining (electric cars), charging status (electric cars), remaining range electric (electric cars). +- Notifications: Send messages or Points of Interest (POI) to your car. - Services: Turn on air condition, sound the horn, flash the lights and update the state. More details can be found [here](/integrations/bmw_connected_drive/#services). ## Configuration @@ -71,6 +73,44 @@ bmw_connected_drive: default: false {% endconfiguration %} +## Notifications + +The `bmw_connected_drive` integration offers a notification service. Using this service you can send messages or Points of Interest (POI) to your vehicle. In your vehicle you can select this POI and the navigation will automatically start using the POI as a destination. +The name of the service is `notify.bmw_connected_drive_`. + +### Examples + +A few examples on how to use the notification service. + +#### Send a text message to your vehicle + +```yaml +... +action: + service: notify.bmw_connected_drive_ + data: + title: Message from Home Assistant # optional, will default to "Home Assistant" when left empty + message: The text of the message you want to send to your vehicle +``` + +#### Send a Point of Interest to your vehicle + +```yaml +... +action: + service: notify.bmw_connected_drive_ + data: + message: The name of the POI # this is shown on the iDrive dashboard + data: + location: + latitude: 48.177024 + longitude: 11.559107 + street: Street name # Optional + city: City name # Optional + postal_code: Postal Code # Optional + country: Country # Optional +``` + ## Services The `bmw_connected_drive` integration offers several services. In case you need to provide the vehicle identification number (VIN) as a parameter, you can see the VIN in the attributes of the device tracker for the vehicle. The VIN is a 17 digit alphanumeric string, e.g., `WBANXXXXXX1234567`.