Aller au contenu principal

Intégration domotique Carte des artisans, gratuite et open source

Intégration Carte des artisans pour Gladys Assistant

Trouvez les artisans près de chez vous : plus de 3 millions d'entreprises, labels RGE et EPV.

Voir sur GitHubToutes les intégrations

Trouvez les artisans de votre métier autour de votre maison, directement dans Gladys : plombiers, électriciens, menuisiers, boulangers, garagistes… L'intégration lit les données publiques de la Carte des artisans, un site indépendant (non affilié à l'Insee ni aux chambres de métiers et de l'artisanat) qui recense plus de 3 millions d'établissements artisanaux actifs en France métropolitaine et en Corse.

Avant de commencer​

  • Gladys 5.1 ou plus récent.
  • La position de votre maison doit être renseignée dans Paramètres › Maisons. L'intégration cherche autour de la première maison localisée (par ordre alphabétique).
  • L'installation demande l'accès à la position de la maison : elle ne sert qu'à calculer les distances, dans Gladys. Elle n'est jamais envoyée au site ni à un autre service.

Il n'y a rien à régler dans l'onglet Configuration : le bouton Tester la connexion vérifie que les données sont lisibles et que la maison est localisée.

Widget « Artisans près de chez moi »​

Ajoutez-le à un tableau de bord, puis choisissez dans ses réglages :

  • Métier : l'une des 126 rubriques de la Carte des artisans ;
  • Rayon : 5, 10, 25 ou 50 km autour de la maison ;
  • Seulement les entreprises labellisées (RGE, EPV, Maître artisan).

Le widget affiche le nombre d'artisans trouvés et jusqu'à 8 entreprises. Un appui sur une entreprise montre son activité, son adresse, ses labels, son téléphone si l'artisan l'a ajouté, et les liens Voir la fiche et Itinéraire. Le bouton Voir sur la carte ouvre la carte du site pour ce métier et votre commune (jamais votre position exacte).

Ajoutez plusieurs widgets pour suivre plusieurs métiers.

Ordre des résultats​

Comme sur le site : les entreprises labellisées (RGE, Entreprise du patrimoine vivant, Maître artisan) d'abord, puis les plus proches.

Entrées « Sponsorisé »​

En tête de liste peuvent apparaître jusqu'à 3 entrées marquées Sponsorisé : ce sont des artisans qui ont souscrit l'option payante « Artisan recommandé » pour ce métier dans votre département ou votre commune. Elles sont tirées au hasard, toujours signalées, et n'ont aucun effet sur les autres résultats ni sur leur ordre. L'action de scène n'en renvoie jamais. Détails : règles de classement.

Action de scène « Chercher un artisan »​

Dans l'éditeur de scènes, catégorie Intégrations. Choisissez le métier, le rayon et éventuellement « labellisés seulement ». L'action fournit aux actions suivantes de la scène :

VariableContenu
trouvevrai si au moins un artisan a été trouvé
nombrenombre d'artisans dans le rayon
nomnom du premier artisan (labellisés d'abord)
telephoneson téléphone, s'il l'a ajouté sur le site
adresseson adresse
distancesa distance à la maison (« 2,4 km »)
lienlien vers sa fiche sur cartedesartisans.fr

Exemple : une alerte de fuite d'eau qui envoie un message « Plombier le plus proche : nom, téléphone, lien ».

Données et vie privée​

  • Sources : Sirene (Insee) et répertoire des métiers (CMA), licence ouverte, mises à jour une fois par mois ; labels RGE (ADEME) et EPV (DGE).
  • L'intégration télécharge seulement les fichiers nécessaires (un par métier et par département proche, quelques kilo-octets), les garde dans son dossier /data et ne les relit qu'à la mise à jour mensuelle. Les informations ajoutées par les artisans (téléphone, labels Maître artisan, artisans recommandés) sont relues toutes les 6 heures.
  • Aucune donnée vous concernant n'est envoyée : ni position, ni identifiant, ni cookie. Les liens vers le site portent seulement mtm_campaign=gladys, pour compter les visites venues de Gladys.

Dépannage​

  • « Indiquez la position de votre maison » : renseignez-la dans Paramètres › Maisons, puis rouvrez le tableau de bord.
  • « Ce métier n'existe plus » : la rubrique a été retirée du site ; choisissez-en une autre dans les réglages du widget.
  • Aucun résultat : élargissez le rayon.
  • Une erreur sur une entreprise (adresse, retrait) : utilisez le lien « Signaler une erreur » de sa fiche sur le site.

Paramètres de configuration​

Voici les paramètres demandés par Carte des artisans dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
FonctionnementsectionNonRien à régler ici : l'intégration cherche autour de la position de votre maison Gladys. Ajoutez le widget « Artisans près de chez moi » à un tableau de bord, ou l'action « Chercher un artisan » à une scène. Données : Sirene (Insee) et répertoire des métiers (CMA), mises à jour chaque mois, lues sur cartedesartisans.fr, site indépendant (non affilié à l'Insee ni aux chambres de métiers et de l'artisanat). Votre position ne quitte jamais Gladys.

Comment installer Carte des artisans dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Carte des artisans apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/tlse-vins/gladys-carte-des-artisans:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/tlse-vins/gladys-carte-des-artisans.

Carte des artisans nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Carte des artisans est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par tlse-vins, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le