Google Maps location sharing device tracker (#12301)

* Google Maps location sharing device tracker.

* Use ConfigType and change debug logging to _LOGGER.debug()

* Update to locationsharinglib 0.3.0

* Remove unneeded lines.

* Use hass.config.path for config file location.

* Fixed remarks

* Return boolean in setup_scanner

.coveragerc

@@ -374,6 +374,7 @@ omit =
     homeassistant/components/device_tracker/cisco_ios.py
     homeassistant/components/device_tracker/ddwrt.py
     homeassistant/components/device_tracker/fritz.py
+    homeassistant/components/device_tracker/google_maps.py
     homeassistant/components/device_tracker/gpslogger.py
     homeassistant/components/device_tracker/hitron_coda.py
     homeassistant/components/device_tracker/huawei_router.py

homeassistant/components/device_tracker/google_maps.py

@@ -0,0 +1,83 @@
+"""
+Support for Google Maps location sharing.
+
+For more details about this platform, please refer to the documentation at
+https://home-assistant.io/components/device_tracker.google_maps/
+"""
+import logging
+from datetime import timedelta
+
+import voluptuous as vol
+
+import homeassistant.helpers.config_validation as cv
+from homeassistant.components.device_tracker import (
+    PLATFORM_SCHEMA, SOURCE_TYPE_GPS)
+from homeassistant.const import CONF_USERNAME, CONF_PASSWORD
+from homeassistant.helpers.event import track_time_interval
+from homeassistant.helpers.typing import ConfigType
+from homeassistant.util import slugify
+
+_LOGGER = logging.getLogger(__name__)
+
+REQUIREMENTS = ['locationsharinglib==0.4.0']
+
+CREDENTIALS_FILE = '.google_maps_location_sharing.cookies'
+
+MIN_TIME_BETWEEN_SCANS = timedelta(seconds=30)
+
+PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({
+    vol.Required(CONF_USERNAME): cv.string,
+    vol.Required(CONF_PASSWORD): cv.string,
+})
+
+
+def setup_scanner(hass, config: ConfigType, see, discovery_info=None):
+    """Set up the scanner."""
+    scanner = GoogleMapsScanner(hass, config, see)
+    return scanner.success_init
+
+
+class GoogleMapsScanner(object):
+    """Representation of an Google Maps location sharing account."""
+
+    def __init__(self, hass, config: ConfigType, see) -> None:
+        """Initialize the scanner."""
+        from locationsharinglib import Service
+        from locationsharinglib.locationsharinglibexceptions import InvalidUser
+
+        self.see = see
+        self.username = config[CONF_USERNAME]
+        self.password = config[CONF_PASSWORD]
+
+        try:
+            self.service = Service(self.username, self.password,
+                                   hass.config.path(CREDENTIALS_FILE))
+            self._update_info()
+
+            track_time_interval(
+                hass, self._update_info, MIN_TIME_BETWEEN_SCANS)
+
+            self.success_init = True
+
+        except InvalidUser:
+            _LOGGER.error('You have specified invalid login credentials')
+            self.success_init = False
+
+    def _update_info(self, now=None):
+        for person in self.service.get_all_people():
+            dev_id = 'google_maps_{0}'.format(slugify(person.id))
+
+            attrs = {
+                'id': person.id,
+                'nickname': person.nickname,
+                'full_name': person.full_name,
+                'last_seen': person.datetime,
+                'address': person.address
+            }
+            self.see(
+                dev_id=dev_id,
+                gps=(person.latitude, person.longitude),
+                picture=person.picture_url,
+                source_type=SOURCE_TYPE_GPS,
+                attributes=attrs
+            )

requirements_all.txt

@@ -480,6 +480,9 @@ liveboxplaytv==2.0.2
 # homeassistant.components.notify.lametric
 lmnotify==0.0.4
 
+# homeassistant.components.device_tracker.google_maps
+locationsharinglib==0.4.0
+
 # homeassistant.components.sensor.luftdaten
 luftdaten==0.1.3