From 6a815f79a23bf3a092f7331106da76e1db1144f8 Mon Sep 17 00:00:00 2001 From: Gerard Date: Sun, 12 Apr 2020 17:21:20 +0200 Subject: [PATCH] Update the docs for the new notification service (#12622) * Update the docs for the new notification service In https://github.com/home-assistant/core/pull/33484 a new notification service for BMW is introduced. * Update source/_integrations/bmw_connected_drive.markdown Co-Authored-By: Franck Nijhof * Update source/_integrations/bmw_connected_drive.markdown Co-Authored-By: Franck Nijhof * Use the same notify service name Co-authored-by: Franck Nijhof --- .../bmw_connected_drive.markdown | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) 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`.