9c875f54a4
* Remove extra backticks for syntax rendering It looks like 2 out of the 3 example configs are incorrect on this page. This should fix them. * Remove more backticks
2.3 KiB
layout, title, description, date, sidebar, comments, sharing, footer, ha_category, ha_release
| layout | title | description | date | sidebar | comments | sharing | footer | ha_category | ha_release |
|---|---|---|---|---|---|---|---|---|---|
| page | GPSLogger | Instructions how to use GPSLogger to track devices in Home Assistant. | 2016-11-25 15:00 | true | false | true | true | Presence Detection | 0.34 |
This platform allows you to detect presence using GPSLogger. GPSLogger is an open source app for Android that allows users to set up a GET request to update GPS coordinates. This can be configured with Home Assistant to update your location.
To integrate GPSLogger in Home Assistant, add the following section to your configuration.yaml file:
# Example configuration.yaml entry
device_tracker:
- platform: gpslogger
{% linkable_title Setup on your smartphone %}
To configure GPSLogger, you must set up the app to send a GET request to your Home Assistant server at
http://<ha_server>/api/gpslogger?latitude=%LAT&longitude=%LON&device=%SER&accuracy=%ACC&battery=%BATT&speed=%SPD&direction=%DIR&altitude=%ALT&provider=%PROV&activity=%ACT
. Make sure to include the API password if you have configured a password in Home Assistant (add &api_password=<password> to the end of the URL). Configure that options under "General Options":
- Start on boot: yes
- Start on app launch: yes
Set the URL under "General Options -> Logging details":
- Log to GPX: no
- Log to KML: no
- Log to custom URL: yes and set
http://<ha_server>/api/gpslogger?latitude=%LAT&longitude=%LON&device=%SER&accuracy=%ACC&battery=%BATT&speed=%SPD&direction=%DIR&altitude=%ALT&provider=%PROV&activity=%ACT
(be sure you include API password (&api_password=<password>) if needed, or you can also use HTTP Basic authentication http://<username>:<password>@<ha_server>/api/gpslogger...)
- Log to OpenGTS Server: no
- Log to Plain Text: no
- Log to NMEA: no
You should also tune GPSLogger performance to save your battery under "General Options -> Logging details -> Performance -> Location providers":
- GPS: no
- Network: no
- Passive: yes
A request can be forced from the app to test if everything is working fine. A succesfull request will update known_devices.yaml with device serial number.