BorisGautier / geosm-backend

Projet Laravel GeOsm

Pré requis

Avant de continuer vous devez déjà avoir:

• PostgreSQL PostGIS installée. Si ce n’est pas le cas, nous vous invitons à suivre ce tutoriel
• PHP (version égale ou supérieure à la 7.2.5)
• Composer

Intallation

Le bon fonctionnement de GeOsm nécessite le respect des étapes suivantes.

I) La base de données

Elle contiendra l'architecture des données.
Dans le dossier BD du depot backend_nodejs, se trouve un ficher template_bd.backup permettant de créer une base données avec le modèle de GeOsm. La procédure est la suivante :

1. Créer une base de données avec l'extension Postgis

2. Importer le fichier template_bd.backup dans la base de données créée précédemment:

$ psql -U username -d database_name -f template_bd.backup --set ON_ERROR_STOP=on

Documentation pour en savoir plus

3. On télécharge le fichier PBF qui nous intéresse sur geofabrik

A titre d’exemple, nous allons télécharger sur GeoFabrik les fichiers PBF relatifs au Cameroun et à la nouvelle région Occitanie (composée des anciennes régions du Languedoc-Roussillon et Midi-Pyrénées):

$ wget https://download.geofabrik.de/africa/cameroon-latest.osm.pbf
$ wget https://download.geofabrik.de/europe/france/languedoc-roussillon-latest.osm.pbf
$ wget https://download.geofabrik.de/europe/france/midi-pyrenees-latest.osm.pbf

4. Importer les données OSM

Il s’agit d’abord d’installer OSM2PGSQL, dont la documentation est disponible sur les pages dédiées de Wikipedia ou LearnOSM

$ apt-get install osm2pgsql

On récupère le fichier de style pour la base de données: default.style toujours dans le dossier BD
Puis on importe le PBF téléchargé dans la base de données :\

• Pour le Cameroun qui contient un seul fichier pbf

$ osm2pgsql --slim -G -c -U username -d database_name -H localhost -W --hstore-all -S default.style cameroon-latest.osm.pbf

• Pour Occitanie qui contient deux fichiers, il est nécessaire de les jumeler dans un premier temps; On se sert alors du logiciel osmconvert:

$ sudo apt-get install osmctools
$ osmconvert midi-pyrenees-latest.osm.pbf -o=midi-pyrenees.o5m
$ osmconvert languedoc-roussillon-latest.osm.pbf -o=languedouc.o5m
$ osmconvert midi-pyrenees.o5m languedouc.o5m -o=merged_occitanie.osm.pbf

Maintenant qu'on a le ficher merged_occitanie.osm.pbf qui contient les deux fichiers PBF téléchargés en (3) on peut l'importer en base de données:

$ osm2pgsql --slim -G -c -U username -d database_name -H localhost -W --hstore-all -S default.style merged_occitanie.osm.pbf

5. Il faut remplir la géométrie de la table instances_gc qui sera la limite de tout notre projet.

Exemple: pour le Cameroun ce sont les limites du Pays, pour Occitanie, ce sont les limites de la région.
Pour l'instant, il s’agit de connecter QGIS sur la base de données et on tente de remplir la table par une requête OSM.
La base de données étant prête, on peut passer au projet PHP

II) Projt PHP: Laravel

1. Déploiement du projet:

Documentation officielle ici

$ composer install

Créer un fichier .env à la racine de votre dossier projet, copiez y le texte ci-dessous en remplaçant les valeurs database_name, username et database_password :

APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack

DB_CONNECTION=pgsql
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=database_name
DB_USERNAME=username
DB_PASSWORD=database_password

BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME="${APP_NAME}"

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1

MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

API_PREFIX=api

intersection=false
simplifyGeometry=0

Ensuite génerer une nouvelle clé

$ php artisan key:generate

2. Modification du projet Laravel

Creer le fichier config.js dans le dossier public/assets et copier le contenu du fichier config_template.js à l'interieur

modifier les entrées urlNodejs et urlNodejs_backend par le lient de votre serveur qgis.

Le projet Laravel est prêt !

3. Configurer Apache ou Nginx

Faire une configuration apache ou nginx pour lier un nom de domaine au projet Laravel qui pointe vers le dossier /projet laravel/public
Par la suite, on appellera nom de domaine "www.serveur_php.geosm"
Après vous pouvez tester dans votre navigateur www.serveur_php.geosm/admin, les identifiants de connexion par défaut sont\

• login : [e-mail]
• mot de passe : 1234

4. Chargez les couches par défaut de GeOsm

Par défault, GeOsm vient avec 112 couches, mais qui ne sont définies que par leurs requêtes OSM; Il faut maintenant exécuter ces requêtes et créer des couches. Elle se fait en deux phases:

• Etape 1 : Vérification que toutes les requêtes sont bonnes, calcul du nombre d'entités trouvées et calcul des surfaces et distances totales.
  Dans l'interface d'administration, menu "Tableau de bord", cliquer sur le bouton "Mettre à jour le serveur de fichiers OSM". ca peut prendre plus de 15 minutes
• Etape 2: Remplissage des couches, elle se fait dans le projet python+Nodejs

Brève description du modèle de données

On n'est partit surtout du fait qu'une couche peut être contenu dans un groupe ou un sous-groupe.
Cette donnée pouvant elle-même ètre vecteur ou raster et de sources différentes.\

On a 4 tables principales qui les gèrent:

• Thematiques : elle contient tous les groupes
• Sous-thematiques: elle contient tous les sous-groupes qui sont lié à un groupe par la clé étrangère id-thematiques de la table thématiques
• couches-sous-thématiques: elle contient toutes les couches qui sont liés à un sous-groupe par la clé étrangère id-sous-thematiques de la table sous-thematiques
• couche-thematiques: elle contient toutes les couches qui sont liés directement à une thématique par la clé étrangère id-thematiques de la table thematiques

Pour lier toutes ces couches aux données OSM, on a 2 tables en plus:

• Catégorie: elle contient la requête sql d'une couche OSM, et est lié à cette couche par la clé étrangère key_couche.
• sous-categorie: qui contient toutes les clauses d'une requête. Si une requête a deux conditions, cette requête aura deux lignes dans la table. Elle est liée à la table catégorie par la clé étrangère id_cat de la table categorie

un apercu de la table sous-categorie: