Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

modif doc owntracks #245

Closed
wants to merge 3 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 25 additions & 17 deletions docs/integrations/owntracks.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,44 +4,52 @@ title: Owntracks
sidebar_label: Owntracks
---

[Owntracks](https://owntracks.org/) is an open-source mobile app which sends the phone location to a server, periodically.
# Owntracks

Gladys Plus allows you to receive Owntracks message and create location in Gladys.
[Owntracks](https://owntracks.org/) is an open-source mobile application that lets you send your geolocation periodically to a server.

**Gladys Plus([https://gladysassistant.com/fr/plus/](https://gladysassistant.com/fr/plus/))** allows you to receive these locations in Gladys.

### Download Owntracks

First download Owntracks on iOS or Android.
First, download Owntracks.

- [Android](https://play.google.com/store/apps/details?id=org.owntracks.android&hl=fr&gl=US)
- [iOS](https://apps.apple.com/fr/app/owntracks/id692424691)

### Create an API key in Gladys Plus

Go to [plus.gladysassistant.com](https://plus.gladysassistant.com/), connect.
Go to [plus.gladysassistant.com](https://plus.gladysassistant.com/), log in.

Then go to "settings" => "Open API", and create a key.
Then go to `Integration -> Open API`, and create a key.

### Go to Owntracks

Click on the button in the top-left corner:
Click on the button at the top left of the app:

![Open API owntracks Gladys](../../static/img/docs/en/configuration/gateway/open-api-owntracks-0.jpg)
![owntracks_carte](../../static/img/docs/en/configuration/gateway/open-api-owntracks-0.jpg)

Click on settings:
Click on `Settings`:

![Open API owntracks Gladys](../../static/img/docs/en/configuration/gateway/open-api-owntracks-1.jpg)
![owntracks_statuts_info](../../static/img/docs/en/configuration/gateway/open-api-owntracks-1.jpg)

Select "HTTP", and in the "URL" input, enter:
Select `HTTP`, then in the `URL` input enter:

```
https://api.gladysgateway.com/v1/api/owntracks/[YOUR-API-KEY]
<https://api.gladysgateway.com/v1/api/owntracks/[YOUR-API-KEY]>

```

Fill in the `UserID` and `DeviceID` field with the terms of your choice (they are mandatory).
In `DeviceID` and `UserID`, put what you want, it's not useful for Gladys but the fields are mandatory.

I personally put "iphone" in `DeviceID` and "Pierre-Gilles" in `UserID`.

I put "iphone" for the `DeviceID`, and "pierre-gilles" for the `UserID`.
Gladys uses the API key to identify your account.

Gladys uses the API key to identify who is making the request.
![owntracks_settings](../../static/img/docs/en/configuration/gateway/open-api-owntracks-2.jpg)

![Open API owntracks Gladys](../../static/img/docs/en/configuration/gateway/open-api-owntracks-2.jpg)
### Check that integration is working

### See your location in Gladys
In Gladys, you should see your position on the `Plans` tab.

You should see your location in Gladys in the "Maps" tab.
Please post a message on [the forum](https://en-community.gladysassistant.com), if you need any help.
Original file line number Diff line number Diff line change
Expand Up @@ -4,44 +4,52 @@ title: Owntracks
sidebar_label: Owntracks
---

[Owntracks](https://owntracks.org/) est une application mobile open-source qui permet d'envoyer sa géolocalisation périodiquement à un serveur.
# Owntracks

Gladys Plus vous permet de recevoir ces localisations dans Gladys.
[Owntracks](https://owntracks.org/) est une application mobile open-source qui permet d'envoyer sa géolocalisation périodiquement à un serveur.

**[Gladys Plus](https://gladysassistant.com/fr/plus/)** vous permet de recevoir ces localisations dans Gladys.

### Télécharger Owntracks

Tout d'abord, téléchargez Owntracks sur iOS ou Android.
Tout d'abord, téléchargez Owntracks.

- [Owntracks pour Android](https://play.google.com/store/apps/details?id=org.owntracks.android&hl=fr&gl=US)
- [Owntracks pour OS](https://apps.apple.com/fr/app/owntracks/id692424691)

### Créez une clé d'API dans Gladys Plus

Allez à [plus.gladysassistant.com](https://plus.gladysassistant.com/), connectez-vous.
Allez à [plus.gladysassistant.com](https://plus.gladysassistant.com/), connectez vous.

Puis allez dans "settings" => "Open API", et créez une clé.
Puis allez dans`Intégration -> Open API`, et créez une clé.

### Allez dans Owntracks

Clickez sur le bouton en haut à gauche de l'app:
Cliquez sur le bouton en haut à gauche de l'app:

![Open API owntracks Gladys](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-0.jpg)
![owntracks_carte](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-0.jpg)

Cliquez sur "paramètres":
Cliquez sur `Paramètres`:

![Open API owntracks Gladys](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-1.jpg)
![owntracks_statuts_info](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-1.jpg)

Sélectionnez "HTTP", puis dans l'input "URL" entrez:
Sélectionnez `HTTP`, puis dans l'input `URL` entrez:

```
https://api.gladysgateway.com/v1/api/owntracks/[YOUR-API-KEY]

```

Dans `DeviceID` et `UserID`, mettez ce que vous voulez, ce n'est pas utile pour Gladys mais les champs sont obligatoires.
Dans `DeviceID` et `UserID`, mettez ce que vous voulez, ce n'est pas utile pour Gladys mais les champs sont obligatoires.

J'ai mis personnellement "iphone" dans `DeviceID` et "pierre-gilles" dans `UserID`.
J'ai mis personnellement "iphone" dans `DeviceID` et "Pierre-Gilles" dans `UserID`.

Gladys utilise la clé d'API pour identifier votre compte.

![Open API owntracks Gladys](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-2.jpg)
![owntracks_settings](../../../../../static/img/docs/fr/configuration/gateway/open-api-owntracks-2.jpg)

### Vérifiez que l'intégration fonctionne

Dans Gladys, vous devriez voir votre position sur l'onglet "Maps".
Dans Gladys, vous devriez voir votre position sur l'onglet `Plans`.

Je vous invite à poster un message sur [le forum](https://community.gladysassistant.com/), si jamais vous avez besoin d’aide.
Loading