GeoRide: Automatisation depuis son intercom

Date de publication: 30/12/2019

Bonjour à toutes et à tous, bande de geeks ! Étant motard depuis peu, le père Noël m’a récemment offert un boitier GeoRide. Pour ceux qui ne connaissent pas cette merveille, GeoRide est un boitier Tracker GPS, alarme connectée et détecteur de chutes. En d’autres mots c’est le garde du corps idéal pour votre compagnon à 2 roues. Je ne suis en aucune façon payé par GeoRide pour écrire cet article, c’est juste que je kiffe énormément ce produit. Après, si l’équipe de Dev tombe sur cet article et me propose un partenariat, ça se discute les gars hein.

Introduction

GeoRide est une boite jeune qui a connu un succès fulgurant en France cette dernière année. Et pour cause, la qualité de leur boitier, leur support efficace et leur constante évolution sont au coeur du système.

 

De par leur jeunesse, l’équipe de dev chez Georide est réactive, créative, utilisant des technologies modernes et efficaces. Ceux qui me connaissent savent pertinemment que ce genre de système me passionne et m’intrigue très fortement. En tant que bon petit fouineur que je suis, je me suis directement intéressé afin d’aller plus loin avec ce boitier. Mais comment aller plus loin avec un produit aussi abouti ? La réponse est l’automatisation.

L’intercom est un boitier installé sur le casque permettant de communiquer entre motards sur la route ou simplement avec son passager. Ce système est aussi muni de fonctionnalités Bluetooth permettant d’écouter de la musique, suivre son GPS ou alors passer des appels téléphoniques. Après une petite heure de recherches/test/implémentation, j’ai réussi à faire en sorte que mon GeoRide se verrouille automatiquement lorsque j’éteins mon intercom (donc, lorsque je suis arrivé quelques part), et se déverrouille lorsque je l’allume (lorsque je pars). De nombreux membres de la communauté GeoRide m’ayant demandé comment faire de même sur leur téléphone Android, j’ai pensé judicieux de créer un tutoriel complet sur mon blog.

Ce tutoriel sera composé de plusieurs chapitres, à suivre dans cet ordre précisemment. Aussi, chaque instruction est importante et doit être appliquée à la lettre. Vous êtes prêts ? Alors, c’est parti !

Prérequis

Applications

Tasker est une boite à outils permettant d’automatiser tout et n’importe quoi sur votre téléphone. Du moment que vous avez l’idée, vous pouvez le faire avec Tasker ! Nous utiliserons cette application afin de déclencher nos actions en fonction de l’état du bluetooth (connecté ou non). Tasker peut être téléchargé depuis le PlayStore pour une bouchée de pain à cette adresse.

Pour les personnes ne souhaitant pas supporter le travail des développeurs mais voulant tout de même télécharger l’application, elle est disponible sur Aptoide à cette adresse, mais chut hein, je ne vous ai rien dit.

Vous allez devoir aussi télécharger l’application HTTP Client, qui va nous permettre de récupérer votre Token d’authentification ainsi que votre Tracker ID. Cette application gratuite est disponible au téléchargement à cette adresse.

Génération du token d’authentification

Afin de pouvoir interagir avec l’API de GeoRide, il vous faut un Token permettant de vous authentifier. Pour ce faire, nous allons faire une requête permettant de générer ce Token.

  1. Ouvrez l’application HTTP Client
  2. Cliquez sur le bouton en bas à droite de votre écran (avec l’icone de crayon dessus)
  3. Entrez “https://api.georide.fr/user/login” dans le champ “URL”
  4. Sélectionnez “POST” dans le champ “Method”
  5. Plus en bas, entrez “email” dans le champ “Key” de la section “Parameters”
  6. Entrez votre adresse mail dans le champ “Value” juste en dessous
  7. Cliquez sur le “ADD”, juste en dessous
  8. Entrez “password” dans le champ “Key”
  9. Entrez votre mot de passe Georide dans le champ “Value” juste en dessous
  10. Cliquez sur le bouton tout en haut à droite de votre écran (icone de flèche)

Une fois la requête realisée, 3 onglets vont apparaître en haut de votre écran: Summary, Request et Response. Rendez-vous dans Response. Un texte similaire à la photo ci-contre va alors apparaitre. Copiez tout le texte après “authToken” et notez-le quelque part. Note: à savoir que les Tokens générés par l’API ne sont valables que pendant 30 jours. Après ce laps de temps, il est nécessaire de regénérer un nouveau token. Cette manipulation sera abordée lors d’un second article, dédié à ce sujet.

Génération du tracker ID

Maintenant que nous nous sommes authentifié auprès de l’API, il nous faut récupérer l’identifiant du tracker de votre boitier afin de pouvoir le controler via l’API:

  1. Ouvrez l’application HTTP Client
  2. Cliquez sur le bouton en bas à droite de votre écran (avec l’icone de crayon dessus)
  3. Entrez “https://api.georide.fr/user/trackers” dans le champ “URL”
  4. Sélectionnez “GET” dans le champ “Method”
  5. Plus en bas, entrez “Authorization” dans le champ “Key” de la section “Headers”
  6. Entrez “Bearer ” suivi de votre token dans le champ “Value” juste en dessous
  7. Cliquez sur le bouton tout en haut à droite de votre écran (icone de flèche)

Une fois la requête réalisée, 3 onglets vont apparaître en haut de votre écran: Summary, Request et Response. Rendez-vous dans Response. Un texte similaire à la photo ci-contre va alors apparaitre. Copiez tout le numero après “trackerId” et notez-le quelque part.

Création des tâches

Nous devons maintenant définir les actions qui vont nous permetre d’intéragir avec l’API GeoRide. Pour cela, nous allons en créer 2. Une pour verrouiller la moto et une pour la déverrouiller.

Verrouillage

  1. Ouvrez l’application Tasker
  2. Rendez-vous dans l’onglet “Tâches”
  3. Cliquez sur le bouton “+” en bas à droite de votre écran
  4. Une barre va alors apparaitre en haut à droite de votre écran, rentrez “Verrouillage moto” dans le zone de texte et cliquez sur le bouton “✔” à droite
  5. Vous entrez alors dans le menu d’édition de la tâche
  6. Cliquez sur le bouton “+” en bas à droite de votre écran
  7. Cliquez sur “Réseau”
  8. Cliquez sur “Requête HTTP”
  9. Vous entrez alors dans le menu d’édition d’action
  10. Dans “Méthode” sélectionnez “Publier” (ou “POST” si vous êtes en anglais)
  11. Dans “URL” entrez “https://api.georide.fr/tracker//lock” (remplacez VotreTrackerId par le trackerId obtenu précédemment, sans les guillemets et sans les <>)
  12. Dans “En-têtes” entrez “Authorization: Bearer ” (sans les guillemets, en respectant bien les espaces et les majuscules et sans les <>)
  13. Cliquez sur la flèche de retour en haut à gauche de votre écran

Déverrouillage

  1. Ouvrez l’application Tasker
  2. Rendez-vous dans l’onglet “Tâches”
  3. Cliquez sur le bouton “+” en bas à droite de votre écran
  4. Une barre va alors apparaitre ne haut à droite de votre écran, rentrez “Déverrouillage moto” dans le zone de texte et cliquez sur le bouton “✔” à droite
  5. Vous entrez alors dans le menu d’édition de la tâche
  6. Cliquez sur le bouton “+” en bas à droite de votre écran
  7. Cliquez sur “Réseau”
  8. Cliquez sur “Requête HTTP”
  9. Vous entrez alors dans le menu d’édition d’action
  10. Dans “Méthode” sélectionnez “Publier” (ou “POST” si vous êtes en anglais)
  11. Dans “URL” entrez “https://api.georide.fr/tracker//unlock” (remplacez VotreTrackerId par le trackerId obtenu précédemment, sans les guillemets et sans les <>)
  12. Dans “En-têtes” entrez “Authorization: Bearer ” (sans les guillemets, en respectant bien les espaces et les majuscules et sans les <>)
  13. Cliquez sur la flèche de retour en haut à gauche de votre écran

Création des profils

Maintenant que nous avons défini les actions à éxécuter, nous devons spécifier dans quelles conditions les déclencher. Pour cela, nous allons créer 2 profils, correspondant aux états “connecté” et “déconnecté” de l’intercom.

Verrouillage

  1. Ouvrez l’application Tasker
  2. Rendez-vous dans l’onglet “Profils”
  3. Cliquez sur le bouton “+” en bas à droite de votre écran
  4. Cliquez sur “Etat”
  5. Cliquez sur “Réseau”
  6. Cliquez sur “Bluetooth connecté”
  7. Dans la section “Nom”, cliquez sur le logo

  1. Sélectionnez votre intercom dans la liste déroulante
  2. Dans la section “Adresse”, cliquez sur le logo

  1. Sélectionnez votre intercom dans la liste déroulante
  2. Cochez la case “Inverser” en bas de la page
  3. Cliquez sur la flèche de retour, en haut à gauche de votre écran
  4. Sélectionnez l’action “Verrouillage moto” dans le menu qui s’affiche

Déverrouillage

  1. Ouvrez l’application Tasker
  2. Rendez-vous dans l’onglet “Profils”
  3. Cliquez sur le bouton “+” en bas à droite de votre écran
  4. Cliquez sur “Etat”
  5. Cliquez sur “Réseau”
  6. Cliquez sur “Bluetooth connecté”
  7. Dans la section “Nom”, cliquez sur le logo

  1. Sélectionnez votre intercom dans la liste déroulante
  2. Dans la section “Adresse”, cliquez sur le logo

  1. Sélectionnez votre intercom dans la liste déroulante
  2. Cliquez sur la flèche de retour, en haut à gauche de votre écran
  3. Sélectionnez l’action “Déverrouillage moto” dans le menu qui s’affiche

C’est déjà fini !

Et voilà ! Désormais, votre boitier GeoRide se verrouillera/déverrouillera automatiquement en fonction de si vous êtes connecté ou non à votre intercom ! Je travaille actuellement afin de rendre cette manipulation encore plus simple. Si vous avez des suggestions, remarques ou améliorations, n’hésitez pas à m’en faire part sur Twitter en me mentionnant, ou en m’envoyant un MP ;) Bonne route et à bientôt ! ✌️