Conversion Latitude/Longitude - Ligne/Pk à partir des jeux de données ouvertes disponibles sur le site data.sncf.com. https://pkfieur.gares.io

psophometric a1e0309d2e Merge branch 'master' of https://git.gares.io/psopho/pkfieur 2 years ago
data 1ba08ce3c5 add geo_clean() 2 years ago
utils 5496c60d89 first commit 2 years ago
.gitignore 5496c60d89 first commit 2 years ago
README.md 972d8b8c9d Update 'README.md' 2 years ago
__init__.py 5496c60d89 first commit 2 years ago
export_geoloc_sncf.py 1ba08ce3c5 add geo_clean() 2 years ago
open_localisateur_ANDROID.py 662e604d69 Update 'open_localisateur_ANDROID.py' 2 years ago
open_pkfieur_PC.py 5496c60d89 first commit 2 years ago

README.md

Description

Le projet Pkfieur est un ensemble d'utilitaires réalisé en Python permettant la réutilisation des données ouvertes géolocalisées disponibles sur data.sncf.com, afin de réaliser des conversions Coordonnées Géographiques <-> Ligne/Pk.

Composition

  • export_geoloc_sncf.py : Permet de générer la base de données.
  • open_localisateur_ANDROID.py : Fonctionne sur smartphone Android pour vous géolocaliser sur le réseau ferroviaire
  • open_pkfieur_PC.py : Fonctionne sur PC pour réaliser les conversions Coordonnées Géographiques <-> Ligne/Pk. Il dispose également d'une fonction pour communiquer avec un périphérique GPS pous vous géolocaliser sur le réseau ferroviaire.

A noter qu'il existe une version Web du Pkfieur : pkfieur.gares.io

pkfieur.gares.io

Installation

Sous Linux

Pré-requis

sudo apt-get install python-pip
sudo apt-get install git

Dépendance

Pandas est nécessaire pour export_geoloc_sncf.py (mise à jour de la base de données) uniquement.

pip install pandas

Récupération du dépôt

Commande à exécuter depuis votre répertoire utilisateur :

git clone https://git.gares.io/psopho/pkfieur.git

Lancement du programme

cd pkfieur
python open_pkfieur_PC.py

Sous Windows

Installation de Python

Allez sur la page Download Python 2.7.12. Cliquez sur Windows x86-64 MSI installer (ou Windows x86 MSI installer pour la version 32 bits). Lancez le fichier téléchargé. Laissez les choix par défaut sur les deux premières pages. Sur la troisième page, intitulée "Customize", sélectionnez l'option "Add python.exe to Path".

Installation de Git

Allez sur la page git-for-windows.github.io/ Cliquez sur Download Lancez le fichier téléchargé et laissez les choix par défaut. Lancez l'invité de commandes (Clic-droit sur le "Bouton Démarrer" > Invite de commandes).

git clone https://git.gares.io/psopho/pkfieur.git

Dépendance

Pandas est nécessaire pour export_geoloc_sncf.py (mise à jour de la base de données) uniquement. Lancez l'invité de commandes (Clic-droit sur le "Bouton Démarrer" > Invite de commandes).

pip install pandas

Lancement du programme

Lancez l'invité de commandes (Clic-droit sur le "Bouton Démarrer" > Invite de commandes).

cd pkfieur
python open_pkfieur_PC.py

Sous Android

Installation de QPython

QPyhton est téléchargeable depuis le Play Store.

Installation de pkfieur

Après avoir récupéré le dépôt depuis votre PC, copiez le dossier pkfieur sur votre smartphone à l'emplacement : Phone/qpython/scripts/.

Utilisation sur PC

Pour lancer Pkfieur, il faut taper en ligne de commande, depuis le dossier où se trouve le programme :

python open_pkfieur_PC.py

open_pkfieur_PC

Le programme se lance avec une interface graphique. Les deux premiers onglets permettent la conversion Coordonnées Géographiques <-> Ligne/Pk. Le troisième onglet permet de communiquer avec un périphérique GPS. On peut par exemple utiliser son smartphone ANDROID sur lequel on installe un logiciel permettant l'envoi des données de géolocalisation au format NMEA par Wifi, par exemple Share GPS.

Utilisation sur ANDROID

Pour utiliser Pkfieur sur smartphone, il faut lancer l'application QPyhton, faire défiler l'écran vers la droite pour accéder au Menu. Puis cliquer sur Programs. Ensuite choisir le dossier pkfieur et cliquer sur open_localisateur_ANDROID.py et enfin sur Run.

open_localisateur_ANDROID

Le programme se lance et affichera votre position dès que le GPS recevra un signal.

Mise à jour des données

Une base de données est disponble avec le pkfieur. Si vous souhaitez mettre à jour les données, il faut utiliser - depuis un PC - le programme export_geoloc_sncf.py disponible sur le Dépôt des projets de Gares.io.

Ensuite, il fonctionne par ligne de commande. Pour mettre à jour la base SQLite :

python export_geoloc_sncf.py

Avec cette commande, les jeux de données disponibles sur le site data.sncf.com sont téléchargées au format JSON et les données sont stockées dans la base de données disponible dans le dossier data/ du répertoire du programme. Pour que les fichiers JSON téléchargés soient supprimés à l'issue de la création de la base, il faut lancer le programme avec la commande suivante :

python export_geoloc_sncf.py -d

Si au lieu d'une base SQLite, vous souhaitez obtenir un fichier au format CSV, il faut lancer cette commande :

python export_geoloc_sncf.py -c

Enfin, pour obtenir une base SQLite et un fichier au format CSV, il faut lancer :

python export_geoloc_sncf.py -s -c