Last Updated on 18 januari 2025 by Syds
Met behulp van deze plugin kun je de afstand tussen de locatie die je ingesteld hebt in Domoticz en een Tile tracker uitrekenen en opslaan in een ‘Distance’ device binnen Domoticz.

De plugin maakt gebruik van de Tile API beschikbaar gesteld door Tile.com, en leest daar al jou Tile trackers uit. Conform de werking van Tile worden ook eventuele IOS of Android telefoons als Tile device toegevoegd. Als je die telefoon niet zichtbaar wilt maken kun je ze op ‘ongebruikt’ zetten op je apparaten overzicht in Domoticz.
Vervolgens calculeert de plugin de afstand tussen de locatie die je in Domoticz onder Settings -> Settings -> System hebt ingesteld en de (gesynchroniseerde) locatie van je Tile trackers m.b.v. van de google maps Distancematrix API en slaat het resultaat op in de automatisch aangemaakte Distance devices in Domoticz.
De update frequentie wordt automatisch ingesteld op basis van de afstand tussen je domoticz locatie en de tile trackers, dit op basis van de kleinste afstand van één van die trackers waarbij de minimale afstand groter moet zijn dan 100m. Dit om de voorkomen dat als je tracker voor langere tijd nabij je domoticz locatie is de update frequentie onnodig op 6 seconden blijft staan.
Let op, deze update frequentie is de frequentie waarmee de Tile API wordt bevraagd om wijzingen in de locatie. Dit staat volledig los van de frequentie waarmee de Tile tracker zijn locatiegegevens deelt met de Tile webservices. Meer info op https://support.thetileapp.com/
De update frequenties zijn als volgt:
minimum afstand | maximum afstand | update frequentie |
> 100m | < 1 km | 6 seconden |
> 1 km | < 5 km | 60 seconden |
> 5 km | < 10 km | 6 minuten |
> 10 km | 60 minuten |
Je kunt de minimum, maximum afstanden en update frequentie naar behoeven zelf aanpassen in de functie ‘distanceInterval’ in plugin.py.
Benodigdheden:
- Tile tracker
- Android of IOS telefoon
- laptop of desktop
- Google account
Up-and-running
- Domoticz
- Python 3.12 of hoger op je Domoticz server
- git (https://github.com/git-guides/install-git)
Stap 1. Account aanmaken op Tile.com
Installeer de Tile app middels de Play Store (Android) of App Store (IOS), onderstaand voorbeeld gaat uit van een Android telefoon.
Zoek binnen de play store op “Tile¨, klik de juiste app aan en kies voor Installeren. Open na de installatie de app en kies voor “Get Started”. Voeg vervolgens een je Tile tracker toe via “Tile Devices”




Je wordt nu gevraagd een account aan te maken. Vul je email adres in, kies een password en accepteer de ‘Terms of Service en Privacy Policy’ en klik op Sign Up. Onhoud je email adres en password, die heb je bij het configureren van de Domoticz plugin nodig.
Vervolg stappen zijn om de app een aantal rechten te geven. Eerst geven we de app rechten om via Bluetooth BLE connectie te kunnen maken met de Tile tracker. Klik op ‘Toestaan’. Daarna is locatie aan de beurt, in de eerste stap geef je toestemming tot locatiegegevens tijdens het gebruik van de app, in de tweede stap geef je toestemming om ook de app in de achtergrond toegang tot de locatiegegevens te geven. Geef vervolgens de app rechten tot je exacte locatie.









Daarna geef je de app rechten om een notificatie te sturen, klik achtereenvolgens op ‘Allow’ en ‘Toestaan’. Tot slot geef je de app rechten om in de achtergrond te werken, klik op ‘Toestaan’
Vervolgens voeg je je Tile tracker toe, klik op het ¨+” ‘Add a Device’ icoon voor het toevoegen van het device.




Druk op het knopje van de Tile tracker, klik op next. De app probeert via Bluetooth BLE connectie te maken met de tracker. Als het goed is wordt je tracker gevonden, klik op ‘Next’ om verder te gaan.
Je kunt nu aangeven waar je de tracker voor wilt gebruiken. Ik heb gekozen voor auto, omdat ik de tracker wil gebruiken voor het bepalen van de locatie van mijn auto. Daarna probeert de app de tracker te bereiken voor het uitvoeren van een geluidstest. Daarna vraagt de app om te testen of je je telefoon kunt vinden d.m.v. het drukken op de knop van je tracker.







Tot slot proberen ze je nog te verleiden tot het afsluiten van een premium abonnement en geven ze je wat nadere info over de werking van de tracker i.c.m. de app. Klik die schermen gewoon door. Je bent nu klaar met het installeren van de app en het toevoegen van de tracker.
Stap 2. Google maps API key aanmaken
In deze stap maken we een google maps API key middels de Google cloud console. Navigeer met je browser naar https://console.cloud.google.com. Log in met je google account.

Omdat ik voor mijn Google assistant integratie, zie https://www.sydspost.nl/index.php/2021/03/16/google-assistant-koppelen-aan-domoticz/, al een project aangemaakt heb genoemd ‘huis’ verwijs ik je graag naar deze blog voor de stappen van het aanmaken van een project. Kies vervolgens binnen je project voor de tegel ‘APIs &Services’.

Kies op het volgende scherm voor “+ ENABLE APIS AND SERVICES¨

Er wordt nu een overzicht met alle mogelijke Google apis, filter daarom op de maps apis in het linker venster onder filter. Nu wordt het zoekresultaat beperkt tot de maps apis. Scroll naar beneden naar de Distancematrix api



De Distancematrix API settings worden geopend, klik op ‘Enable’. Je keert nu terug binnen de Google maps APIs & Services pagina. Kies binnen het linkermenu voor ‘Keys & Credentials’. Kies vervolgens bovenin het scherm voor ‘+ Create credentials’, en kies voor ‘API key’




De API key wordt genereerd. Kopieer en plak deze API key in een Google of Word document oid, en bewaar deze API key. Deze heb je namelijk nodig bij de configuratie van de plugin. Nu moeten we de juiste rechten op Google maps API’s nog toekennen aan de API Key. Klik daarom op ‘Edit API key’. Activeer vervolgens onder API restrictions de optie ‘Restrict Key’ en klik op de Pulldown button. Een lijst met api’s klapt open. Deactiveer alles behalve de API ‘Distance Matrix API’. Klik op ‘OK’, verander eventueel de naam van de key nog in iets zinvols, bijv. ‘Domoticz – Tile plugin’ zodat je in de toekomst weet dat deze key t.b.v. deze plugin is. En klik op ‘SAVE’



De API-key is aangemaakt en je bent nu klaar voor de volgende stap.
Stap 3. Installatie Domoticz – Tile plugin
Log in op je Domoticz server als gebruiker ‘Pi’. Type achtereenvolgens de volgende commando voor het installeren van de plugin:
cd domoticz/plugins
git clone https://github.com/sydspost/Domoticz-Tile-plugin.git
mv Domoticz-Tile-plugin tile
chmod +x tile/plugin.py
sudo pip3 install googlemaps

Nu gaan we verder binnen de webpagina’s van Domoticz. Open een browser en navigeer naar Domoticz. We checken eerst of de locatieinstellingen goed staan. Ga binnen Domoticz naar ‘Instellingen’ -> ‘Instellingen’ en tabblad ‘Systeem’.

Als je locatie nog niet ingesteld staat, zoek dan m.b.v. Google maps de coordinaten van je locatie (rechtermuisknop op de locatie, de bovenste regel bevat je coordinaten, klik daarop en ze worden op het klembord gezet) en vul of plak die in in de velden ‘Breedtegraad’ en ‘Lengtegraad’ en geef je locatie een zinvolle naam, bijv. ’thuis’. Sla de instellingen op door op de knop ‘Bewaar Instellingen’ te klikken.
Ga vervolgens binnen Domoticz naar ‘Instellingen’ -> ‘Hardware’, en klik op het pulldown veld van ‘Type’ en selecteer daar de ‘Tile’ plugin

Geen de plugin een naam, bijv. ‘Tile’. Vul de gebruikersnaam (emailadres) en het wachtwoord van je Tile account in, en kopieer de Google maps API key naar ‘API key’. En klik op ‘Toevoegen’

Toelichting op niet default settings:
Attribuut | Setting | Toelichting |
Naam | bijv. ‘Tile’ | Zinvolle en herkenbare naam voor de plugin |
Type | Tile | De Tile plugin |
Gebruikersnaam | <username> | Het emailadres van je Tile account die je in stap 1. hebt aangemaakt |
Wachtwoord | <password> | Het wachtwoord welke je gekozen hebt bij het aanmaken van het Tile account in stap 1. |
API key | <Google maps API key for Distance matrix> | De Google maps API key die je in stap 2. hebt aangemaakt |
Klik binnen Domoticz op het tabblad “Overige”, en je ziet hier je Tile devices terug. Afhankelijk van of de Tile devices gesynchroniseerd zijn met de TIle API webservices zie ook de gecalculeerde afstand tussen de locatie ingesteld in Domoticz en het Tile device

Zoals je ziet wordt ook standaard een Distance device voor je telefoon aangemaakt. Als je die niet zichtbaar wilt hebben, zet hem dan op ‘ongebruikt’ in je apparatenoverzicht onder ‘Instellingen’ -> ‘Apparaten’
