Aller au contenu principal

Intégration domotique Brottsplatskartan, gratuite et open source

Intégration Brottsplatskartan pour Gladys Assistant

Interventions de la police suédoise près de chez vous, par Brottsplatskartan : compteurs, scènes.

Brottsplatskartan amène dans Gladys les événements publiés par la police suédoise : autour de votre maison, dans un comté (län) ou dans les lieux que vous nommez. Pour chaque zone suivie, Gladys reçoit un appareil avec le nombre d'événements des dernières 24 heures par catégorie (cambriolage, vol, violence, incendie, accident de la route, autre) et le dernier événement. Un déclencheur de scène réagit à chaque nouvel événement, une action de scène lit les événements récents en une phrase, et un widget du tableau de bord les liste.

Les données viennent de polisen.se, géolocalisées par Brottsplatskartan. Non affiliée à Brottsplatskartan ni à la police suédoise.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un accès à Internet depuis Gladys : l'intégration lit brottsplatskartan.se en HTTPS. Ni compte ni clé.
  • Pour la zone de rayon : la position de votre maison dans Gladys (Paramètres → Maisons), ou des coordonnées saisies dans la configuration.
  • La Suède seulement : la police des autres pays n'est pas couverte.

Configuration​

Installez l'intégration (Intégrations → Installer depuis GitHub, adresse https://github.com/guim31/gladys-brottsplatskartan), ouvrez son onglet Configuration et remplissez :

ChampRôle
Latitude / longitude du centreLaissez les deux vides pour utiliser la position de votre maison. Point ou virgule décimale.
Rayon autour du centre2, 5, 10, 20 ou 50 km, ou Désactivé. La police situe souvent un événement au centre d'une ville ou d'un quartier seulement : 10 km ou plus est plus sûr. Par défaut : 10 km.
Comté (län)Facultatif : suivre tous les événements de l'un des 21 comtés.
LieuxFacultatif : communes, villes ou quartiers, séparés par des virgules, comme la police les nomme (ex. Solna, Sundbyberg). Les accents sont facultatifs (Malmo trouve Malmö).
Intervalle de lecture10, 15 ou 30 minutes. Par défaut : 15.
Langue des textesNoms des fonctionnalités (à leur création) et textes envoyés aux scènes. Par défaut : français.

Enregistrez, puis ouvrez l'onglet Découverte et créez les appareils. Afficher les derniers événements interroge le service tout de suite et répond avec les deux événements les plus récents.

Appareils​

Il y a un appareil par zone :

  • Interventions de police près de chez moi : les événements dans le rayon du centre.
  • Interventions de police dans ma zone : les événements du comté choisi, plus ceux des lieux nommés. Il n'existe que si un comté ou des lieux sont renseignés.

Chaque appareil a ces fonctionnalités :

FonctionnalitéTypeSens
Événements (24 h)compteurTous les événements de la zone sur les dernières 24 heures.
Cambriolages (24 h)compteurCambriolages (Inbrott, Stöld/inbrott), tentatives comprises.
Vols (24 h)compteurVols (Stöld, vols de véhicules…).
Violences (24 h)compteurAgressions, vols avec violence, coups de feu, menaces, meurtres, infractions sexuelles.
Incendies (24 h)compteurIncendies, incendies criminels, alarmes incendie.
Accidents de la route (24 h)compteurAccidents de la route de tout type.
Autres événements (24 h)compteurTout le reste (alcool au volant, escroqueries, disparitions, contrôles…).
Dernier événementtexteType (traduit, avec le libellé suédois), lieu, date et distance.
Distance du dernier événementkmZone de rayon seulement : la distance entre le dernier événement et le centre.

Les compteurs glissent : un événement en sort 24 heures après sa publication. Les résumés d'une nuit ou d'une journée que la police publie pour tout un comté (« Sammanfattning natt ») sont écartés : ils répètent des événements déjà listés.

Widget​

Événements de police liste les événements de toutes vos zones des dernières 24 heures, du plus récent au plus ancien (8 lignes au plus) : le type, le lieu, l'heure et la distance, avec une pastille de couleur pour la catégorie. Touchez une ligne pour lire le titre et le résumé de la police (en suédois, tels que publiés) et ouvrir l'événement sur Brottsplatskartan.

Déclencheur de scène​

Brottsplatskartan : nouvel événement de police se déclenche dès qu'un nouvel événement de l'une de vos zones est lu, s'il a été publié moins de deux heures avant. Vous pouvez le filtrer par zone (près de chez moi, ma zone) et par catégorie. Un événement des deux zones déclenche une fois par zone : filtrez sur la zone pour éviter les doublons. Les événements déjà listés au premier démarrage, après un redémarrage ou après un changement de réglages ne déclenchent rien.

Variables : zone, category, zone_name, category_name, type (suédois), type_name (traduit), place, location, distance_km (vide sans centre ou pour un événement situé au comté seulement), headline (suédois), summary, time (ISO 8601) et url.

Action de scène​

Brottsplatskartan : lire les événements récents renvoie text (les événements des dernières 24 heures en une phrase, cinq au plus, du plus récent au plus ancien) et count. Elle relit le service si la dernière lecture date de plus d'un intervalle.

Exemples de scènes​

  • Un cambriolage près de chez moi : déclencheur nouvel événement de police, zone Près de chez moi, catégorie Cambriolage → envoyer un message avec les variables summary et url.
  • Point du matin : chaque jour à 7 h 30 → lire les événements récents → dire ou envoyer sa sortie text.
  • Incendie dans le quartier : déclencheur nouvel événement de police, catégorie Incendie, puis une condition sur distance_km inférieure à 3 → allumer une lampe et envoyer une notification.

Dépannage​

  • Pas d'appareil de rayon, ou « Aucun centre pour le rayon » : indiquez la position de votre maison dans Gladys, ou saisissez les deux coordonnées.
  • Peu d'événements près de chez moi : la police situe beaucoup d'événements au centre d'une ville ou d'un quartier seulement, ou au niveau du comté (ceux-là ne comptent jamais dans la zone de rayon). Élargissez le rayon, ou suivez le comté ou la commune.
  • Un lieu ne trouve rien : écrivez-le comme la police (la commune, ex. Solna, ou un quartier listé sur Brottsplatskartan).
  • « Brottsplatskartan ne répond pas » : le service est en panne ou injoignable ; l'intégration réessaie à chaque intervalle et le dit une fois dans les logs quand il revient.
  • Logs : LOG_LEVEL=debug montre chaque lecture. La position de votre maison n'est jamais écrite dans les logs.

Limites​

  • Ce n'est pas une alarme : la police publie ses événements de quelques minutes à quelques heures après les faits, et seulement ceux qu'elle choisit de rendre publics.
  • Un lieu correspond à la commune, mais aussi aux quartiers et rues que la police nomme : un nom courant (un quartier appelé Centrum) peut attraper des événements ailleurs en Suède. Préférez une commune.
  • Les alarmes (Larm inbrott, Larm överfall) comptent comme autres événements, pas comme cambriolages.
  • Les positions sont approchées (une ville, un quartier, une rue) et viennent de la géolocalisation de Brottsplatskartan.
  • Titres et résumés restent en suédois ; les types d'événements sont traduits d'après une liste des types de la police, un type inconnu reste en suédois.
  • L'intégration garde trois jours d'événements : le dernier événement d'une zone calme depuis plus longtemps indique « Aucun événement récent ».
  • Conditions de l'API (brottsplatskartan.se/sida/api) : libre pour un usage non commercial, chaque appel porte le paramètre app, 500 appels par minute au plus. L'intégration ne lit que les nouveaux événements, une fois par intervalle (une centaine d'appels par jour).

Crédits​

Données : la police suédoise (polisen.se), par Brottsplatskartan. L'idée vient de l'intégration Home Assistant brottsplatskartan. Non affiliée à Brottsplatskartan ni à la police suédoise.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Vos zonessectionNonLes événements publiés par la police suédoise, autour de votre maison (ou de coordonnées) et/ou dans un län ou des lieux nommés. Chaque zone est un appareil. Enregistrez, puis créez les appareils dans l'onglet Découverte.
Sources et limitessectionNonÉvénements de la police suédoise (polisen.se), géolocalisés par Brottsplatskartan, lus sans compte. Publiés de quelques minutes à quelques heures après les faits, souvent situés à la ville ou au quartier. Pas une alarme. Non affiliée à Brottsplatskartan ni à la police.
Latitude du centrestringNonLaissez les deux coordonnées vides pour utiliser la position de votre maison dans Gladys.
Longitude du centrestringNonDegrés décimaux, positifs à l'est.
Rayon autour du centreselectNonLa police situe souvent un événement à la ville ou au quartier seulement : 10 km ou plus est plus sûr. Désactivé : pas de zone de rayon.
Comté (län)selectNonFacultatif : suivre aussi tous les événements d'un län, dans un second appareil.
LieuxstringNonFacultatif, dans le même appareil que le län : communes, villes ou quartiers, séparés par des virgules, comme la police les nomme (ex. Solna, Sundbyberg).
Intervalle de lectureselectNonBrottsplatskartan garde ses réponses en cache quelques minutes : lire plus souvent n'apporte rien.
Langue des textesselectNonNoms des fonctionnalités (à leur création) et textes envoyés aux scènes.

Comment installer Brottsplatskartan dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Brottsplatskartan 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/guim31/gladys-brottsplatskartan: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/guim31/gladys-brottsplatskartan.

Brottsplatskartan 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​

Brottsplatskartan 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 guim31, 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 🙂