Client Python Star API : Documentation¶
La STAR (société qui gère les transports en commun de Rennes Métropole) fournit des données sur son service de transport, dont des données temps réels.
Lors de l’ouverture de données temps réel en Open-Data, il était plus que temps de se pencher dessus, et de proposer un client en python pour interroger l’API Open-Data de la STAR.
Cette documentation propose de décrire le fonctionnement de ce client.
Amusez-vous bien, et bon voyage.
Licence et notes aux utilisateurs¶
Ce client est développé sous licence LGPL, par un développeur du Collectif Open-Data Rennes, association indépendante de Kéolis, de la STAR, et de Rennes Métropole.
Ce n’est donc pas un client “officiel”, mais nous espérons qu’il sera satisfaisant.
Installation¶
Première étape : récupérer les sources du projet. C’est facile, c’est disponible sur le dépot Bitbucket, soit un tag soit la dernière version de développement, par exemple comme ceci :
hg clone https://bitbucket.org/exirel/star_api
Après avoir téléchargé les sources du projet, l’installation se fait avec setuptools, avec les droits administrateurs :
cd star_api
python setup.py install
Ceci doit installer le module starapi
ainsi que sa dépendance
principale, le module requests. Il est conseillé d’avoir le module lxml
d’installé pour des questions de performance, mais le client fonctionne aussi
bien sans (quoi que peut-être un peu moins véloce sur le traitement du XML).