home-assistant.io/source/_components/device_tracker.google_maps.markdown
Michaël Arnauts 481fb147c7 New Component: Add docs for Google Maps Location Sharing (#4646)
* Add docs for Google Maps Location Sharing

* Typo

* ✏️ Small updates

* ✏️ Migrated to configuration tags and ups HA version
2018-04-02 16:36:28 +02:00

1.9 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_release, ha_category, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_release ha_category ha_iot_class
page Google Maps Location Sharing Instructions how to use Google Maps Location Sharing to track devices in Home Assistant. 2017-02-12 10:00 true false true true google_maps.png 0.67 Presence Detection Cloud Polling

The google_maps platform allows you to detect presence using the unofficial API of Google Maps Location Sharing.

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.

This platform will create a file named google_maps_location_sharing.conf where it caches your login session.

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. 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.

To integrate Google Maps Location Sharing in Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  platform: google_maps
  username: example@gmail.com
  password: password

{% configuration %} username: description: The email address for the Google account that has access to your shared location. required: true type: string password: description: The password for your given username. required: true type: string {% endconfiguration %}