Informations

OSRoad est une interface web d'affichage de données stockées en base MySQL sur une carte OpenStreetMap, via OpenLayers.

Copyright (C) 2009 - Jean CARTIER

Ce programme est un logiciel libre ; vous pouvez
le redistribuer et/ou le modifier au titre des clauses
de la Licence Publique Générale GNU, telle que publiée
par la Free Software Foundation ;
soit la version 2 de la Licence, ou (à votre discrétion)
une version ultérieure quelconque. Ce programme est
distribué dans l'espoir qu'il sera utile, mais
SANS AUCUNE GARANTIE ; sans même une garantie implicite
de COMMERCIABILITE ou DE CONFORMITE A UNE UTILISATION
PARTICULIERE.
Voir la Licence Publique Générale GNU pour plus
de détails.
Vous devriez avoir reçu un exemplaire de la Licence
Publique Générale GNU avec ce programme ; si ce n'est
pas le cas, écrivez à la
Free Software Foundation Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Cette application s'appuie pour la partie
administration sur les icones sous licence GPL de l'adresse :
http://www.woothemes.com/2009/02/wp-woothemes-ultimate-icon-set-first-release/

Prérequis

Base de donnée MySql
PHP avec support de MySql
Serveur web

Installation de OSRoad

1 - Décompresser et installer l'ensemble des fichiers
et répertoires dans l'arborescence du serveur web.

2 - Importer le dump dump_osroad.sql dans le serveur
de base de données

3 - Modifier le fichier admin/config.inc.php afin de
configurer les 4 variables de connexion à la base de
données :
- nom du serveur de bases de données
- nom de la base de données
- identifiant de l'utilisateur de la base de données
- mot de passe de l'utilisateur de la base de données

Utilisation d'OSRoad

OSRoad est fourni avec un jeu d'exemple reprenant
quelques routes du département du Cher.
La page d'accueil du site (index.php) est en fait la
seule page visible à l'internaute.
La partie administration est accessible dans /admin/
Il existe 2 administrateurs par défaut :
admin (mot de passe osroad)
et demo (mot de passe demo)
ayant les mêmes droits.
Bien que prévue la gestion de droits n'est pas encore
implémentée.
Vous pouvez jouer avec le jeu de test pour constater
le fonctionnement de l'application.

Adaptation d'OSRoad

Ajout d'une route à OSRoad

Il est possible d'ajouter un tracé au format GPX dans
le répertoire /gpx/ d'OSRoad et de pemettre ainsi de
créer de nouvelles routes dans la section /admin/
Il existe de nombreux services sur le web pour créer
de tels fichiers GPX. Citons JOSM pour Openstreetmap
par exemple, ou GPSie (qui n'est pas libre).

Modification de la carte par défaut

Il est possible d'adapter OSRoad à vos besoins et
ainsi d'afficher un autre département, une autre
région, une autre entité.
Les fichiers des contours des entités administratives
françaises sont disponibles à l'adresse :
http://wiki.openstreetmap.org/wiki/WikiProject_France/Limites_administratives
Cliquez sur le lien XML à droite de chaque entité
et ajoutez /full à l'url obtenue. Enregistrez alors
le fichier pour l'utiliser comme contour dans OSRoad.
Il sera cependant certainement nécessaire de diminuer
le nombre de points du fichier. Aussi, ouvrez le
fichier dans JOSM, puis enregistrez le au format GPX.
Diminuez le nombre de points grâce à GPSBabel.
Copiez le fichier gpx ainsi obtenu dans le répertoire
/gpx/ de l'application OSRoad et rendez-vous dans la
section administration afin de modifier le contour
par défaut (cher.gpx) par votre contour.
Il vous fadra aussi adapter le zoom, ainsi que les
coordonnées (latitude/longitude) de l'affichage par
défaut de la carte. La carte du site :
http://www.openstreetmap.org/
vous permet de vous positionner sur votre entité
(département, région, ...) par déplacement et zoom.
Le lien en bas à droite de la page vous donne accès
aux informations de zoom, latitue et longiyude de la
carte courante.

Ajout de pictorammes dans OSRoad

Vous pouvez modifier les pictogrammes (points) 
affichés dans OSRoad :
Créez votre pictogramme au format png avec
transparence. Copiez ce pictogramme dans le
répertoire /icons/ de l'application.
Modifiez le fichier /admin/config.inc.php en ajoutant
les 2 lignes suivantes par pictogramme ajouté :
$icon[X] = "Y.png";
$icon_text[X] = "Z";
où X est un chiffre en séquence, (il ne doit pas y
avoir 2 lignes $icon[X] avec 2 chiffres X identiques),
où Y est le nom du fichier png nouvellement créé,
où Z est le texte descriptif de l'icone (légende sur
la page d'accueil).

Modification des couleurs et styles de tracés

A venir. Aussi modifiable dans /admin/config.inc.php