Google Maps

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

Setup

You first need to create an additional Google account and share your location with that account. This integration will use that account to fetch the location of your device(s).

1. You have to setup sharing through the Google Maps app on your mobile phone. You can find more information here.
2. You need to use the cookies from that account after you have properly authenticated which you can retrieve with either Export cookies for Firefox (make sure that “Prefix HttpOnly cookies” is unchecked) or cookies.txt for Chrome/Chromium.
3. Save the cookie file to your Open Peer Power configuration directory with the following name: .google_maps_location_sharing.cookies. followed by the slugified username of the NEW Google account. Make sure to use the .com TLD (e.g., maps.google.com), otherwise the cookie won’t be able to provide a valid session.
   • For example: If your email address was location.tracker@gmail.com, the filename would be: .google_maps_location_sharing.cookies.location_tracker_gmail_com.

Configuration

To integrate Google Maps Location Sharing in Open Peer Power, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: google_maps
    username: YOUR_USERNAME

Once enabled and you have rebooted devices discovered through this integration will be listed in the known_devices.yaml file within your configuration directory.

They will be created with indentifiers like google_maps_<numeric_id>. To be able to properly track entities you must set the track attribute to true.