Skip to content

Commit 481fb14

Browse files
michaelarnautsfrenck
authored andcommitted
New Component: Add docs for Google Maps Location Sharing (home-assistant#4646)
* Add docs for Google Maps Location Sharing * Typo * ✏️ Small updates * ✏️ Migrated to configuration tags and ups HA version
1 parent 5f4f743 commit 481fb14

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
layout: page
3+
title: "Google Maps Location Sharing"
4+
description: "Instructions how to use Google Maps Location Sharing to track devices in Home Assistant."
5+
date: 2017-02-12 10:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
logo: google_maps.png
11+
ha_release: 0.67
12+
ha_category: Presence Detection
13+
ha_iot_class: "Cloud Polling"
14+
---
15+
16+
The `google_maps` platform allows you to detect presence using the unofficial API of [Google Maps Location Sharing](https://myaccount.google.com/locationsharing).
17+
18+
You first need to create an additional Google account and share your location with that account. This platform will use that account to fetch the location of your device(s). You have to setup sharing through the Google Maps app on your mobile phone. You can find more information [here](https://support.google.com/accounts?p=location_sharing).
19+
20+
This platform will create a file named `google_maps_location_sharing.conf` where it caches your login session.
21+
22+
<p class='note warning'>
23+
Since this platform is using an official API with the help of [locationsharinglib](https://github.com/costastf/locationsharinglib), Google seems to block access to your data the first time you've logged in with this component.
24+
This issue can be fixed by logging in with your new account and approving your login on the [Device Activity](https://myaccount.google.com/device-activity) page.
25+
</p>
26+
27+
To integrate Google Maps Location Sharing in Home Assistant, add the following section to your `configuration.yaml` file:
28+
29+
```yaml
30+
# Example configuration.yaml entry
31+
device_tracker:
32+
platform: google_maps
33+
username: example@gmail.com
34+
password: password
35+
```
36+
37+
{% configuration %}
38+
username:
39+
description: The email address for the Google account that has access to your shared location.
40+
required: true
41+
type: string
42+
password:
43+
description: The password for your given username.
44+
required: true
45+
type: string
46+
{% endconfiguration %}

0 commit comments

Comments
 (0)