Manuel utilisateur Chouette Convert
Fonctionnement de l'API de Chouette Convert
Chouette Convert est une API pour convertir un fichier de données dans un autre format (GTFS, NeTEx, etc).
Cette API est uniquement accessible sur une URL sécurisée en HTTPS. Le protocole HTTPS (Hyper Text Transfer Protocol Secure) est une extension sécurisée du protocole HTTP. Le « S » pour « Secured » (sécurisé) signifie que les données échangées entre le navigateur de l’internaute et le site web sont chiffrées et ne peuvent en aucun cas être espionnées (confidentialité) ou modifiées (intégrité). Dans la barre d’adresse du navigateur, l’URL utilisée sera avec HTTP avec un cadenas vert et le mot « Sécurisé ».
Un token vous sera fourni afin de convertir et récupérer le fichier sur cette API.
Vous trouverez ci-dessous les conversions prises en compte par l’API :
Neptune => GTFS
GTFS => NeTEx
NeTEx => NeTEx
Concernant le NeTEx plusieurs profils sont utilisables :
Français
Européen
Conversion par ligne de commande
enRoute met également à disposition un client opensource. Une description de son utilisation est disponible sur le repository bitbucket :
https://bitbucket.org/enroute-mobi/secretary-client/src/main/
Vous trouverez dans les sources la mise à disposition des exécutables pour toutes les plateformes (Dans le menu voir “Downloads“).
Une fois votre token récupéré, vous pouvez l’inclure dans un fichier de configuration ~/.secretary-client.yaml :
convert-token: "here-your-token"Il suffit ensuite de lancer une conversion avec le secretary-client :
➜ secretary-client create conversion --type=gtfs-netex --profile=european gtfs.zip
Using config file: /home/user/.secretary-client.yaml
Conversion a0c06700-9cd9-4f5e-b194-721d370a16d5 created for gtfs.zip
Plusieurs types de conversion sont utilisables :
Neptune => GTFS :
type=neptune-gtfsGTFS => NeTEx :
type=gtfs-netexNeTEx => NeTEx :
type=netex-netex
ainsi que plusieurs profils NeTEx :
français :
--profile=frencheuropéen :
--profile=european