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 <frenck@frenck.nl>

* Update source/_integrations/bmw_connected_drive.markdown

Co-Authored-By: Franck Nijhof <frenck@frenck.nl>

* Use the same notify service name

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Gerard 2020-04-12 17:21:20 +02:00 committed by GitHub
parent 15ae6e74ea
commit 6a815f79a2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -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_<your_vehicle>`.
### 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_<your_vehicle>
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_<your_vehicle>
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`.