SAM

SAM — Seul Au Monde, ou Somewhere Away from Mankind.

Application web libre permettant de rechercher, sur une carte, un emplacement géographiquement éloigné des traces de présence humaine connues d'OpenStreetMap.

Le cas d'usage d'origine est la préparation de bivouacs et d'affûts photographiques, mais l'outil reste générique : il mesure une distance à des obstacles, rien de plus.

⚠️ SAM ne garantit rien : ni l'absence de personnes, ni l'absence de propriété privée, ni l'autorisation de bivouaquer, ni l'accès légal, ni la sécurité, ni l'exhaustivité des données. Les données OpenStreetMap sont incomplètes par nature. L'application mesure uniquement un isolement d'après les données disponibles et les critères choisis.

État du projet

🚧 V0 — preuve de concept. L'algorithme fonctionne de bout en bout, mais sur des obstacles fictifs générés dans la zone que vous dessinez : cette version ne parle pas encore à OpenStreetMap. Son but est de valider le calcul avant d'ajouter la complexité des vraies données.

Vous pouvez déjà : dessiner une zone, générer des obstacles, cliquer un point approximatif, lancer l'optimisation, et obtenir jusqu'à trois emplacements avec leur cercle d'isolement et les obstacles qui les limitent.

Prochaine étape (V1) : proxy PHP vers Overpass, normalisation des données OSM, cache SQLite, repères manuels. Voir doc/CAHIER_CONCEPTION_ISOLEMENT_OSM.md.

Ce que mesure vraiment le score

SAM ne connaît aucun obstacle hors de la zone étudiée. Un emplacement collé au bord semblerait donc merveilleusement isolé, alors qu'une autoroute peut passer dix mètres plus loin, juste en dehors.

Le score est pour cette raison plafonné par la distance au bord de la zone : on ne certifie un isolement que jusqu'à la limite de ce qui a été examiné. Le cercle affiché ne déborde donc jamais de la zone, et quand c'est le bord qui limite le résultat, il est nommé explicitement parmi les éléments limitants — cela signifie « agrandissez la zone », et non « c'est isolé ».

Tests

node src/tests.js

39 vérifications sans aucune dépendance : primitives géométriques, exactitude de l'index spatial comparée à un balayage exhaustif, et comportement de l'optimiseur sur des cas dont on connaît la réponse.

Installation

Prérequis : PHP 8.0+ avec l'extension pdo_sqlite. Pas de Composer, pas de npm, pas de build, pas de Docker.

1. Copier les fichiers du dépôt sur un hébergement PHP classique.
2. Copier inc/inc_config_perso.example.php en inc/inc_config_perso.php et y ajuster ce qui doit l'être (au minimum env et debug en production).
3. S'assurer que le dossier bddsam/ est accessible en écriture par le serveur web : le cache SQLite y est créé automatiquement.
4. Ouvrir le site.

En développement :

php -S localhost:8000

Choix techniques

• PHP 8 natif, sans framework. Le serveur ne fait que servir les pages et jouer le rôle de proxy contrôlé vers Overpass.
• Les calculs se font dans le navigateur, en JavaScript natif, dans un Web Worker, pour ne pas charger le serveur et garder l'interface réactive.
• SQLite uniquement comme cache des réponses Overpass. Aucun compte utilisateur, aucune donnée personnelle stockée.
• Vanilla JS + Leaflet + Bootstrap, sans chaîne de compilation. Les bibliothèques sont stockées localement dans assets/, pas chargées depuis un CDN.
• Le code est écrit pour être lu : fonctions courtes, commentaires expliquant les choix, les unités et les hypothèses géométriques.

Arborescence

index.php      page principale (carte)
assets/        css, js, polices et bibliothèques tierces (vendor/)
inc/           configuration et fonctions utilitaires PHP
api/           proxy PHP vers Overpass + cache
src/           moteur JavaScript (géométrie, index spatial, normalisation OSM)
bddsam/        cache SQLite (non versionné)
doc/           cahier de conception

Données OpenStreetMap

Les données affichées et utilisées pour les calculs proviennent d'OpenStreetMap, sous licence ODbL. L'attribution « © les contributeurs OpenStreetMap » doit rester visible sur la carte.

Deux choses à ne pas confondre :

• la licence des données (ODbL), qui autorise leur réutilisation sous conditions ;
• les conditions d'utilisation des serveurs publics OSM et Overpass, qui sont des ressources partagées, financées par des dons, et ne constituent pas un backend gratuit et illimité.

SAM interroge donc Overpass à travers un proxy qui limite la surface des requêtes, applique un timeout et met les réponses en cache. Ces serveurs ne font pas partie des ressources fournies ou garanties par ce projet, et l'instance interrogée est configurable dans inc/inc_config.php.

Licence

Code sous licence MIT (voir LICENSE) : réutilisation, modification, redistribution et auto-hébergement libres.

Cette licence ne couvre ni les données OpenStreetMap (ODbL), ni les bibliothèques tierces incluses, qui conservent leurs propres licences.