Exploiter les données

Principes et terminologie

Vigilo permet aux usagers de créer des observations. Une observation est composée des données suivantes :

  • une photo
  • un identifiant unique à 8 caractères appelé token (ici QMWHHPRF)
  • une catégorie
  • d’une date d’observation
  • de coordonnées GPS
  • un nom de rue
  • un commentaire court – Pour affichage sur l’image
  • un commentaire long – Pour explication en annexe

Floutage et modération

L’usager est invité à masquer les visages et plaques d’immatriculations. Ce n’est pas obligatoire mais recommandé pour faciliter le travail des modérateurs. Ces modérateurs sont les administrateurs de l’association Vélo Piéton Châtillon. Ils veillent au respect de la vie privée des personnes et véhicules pris en photo.

L’observation est automatiquement publiée et visible sur la carte de la ville.

http://vigilo.vpchatillon.fr

Toutefois, tant que les modérateurs n’ont pas validé observation, la photo restera floue. L’observation peut être rejetée si elle ne respecte pas les conditions d’utilisation.

Accès à une observation

Reprenons notre observation donnée en exemple précédemment. Le token est QMWHHPRF. Il est possible d’accéder à l’observation avec l’url suivante :

https://api.vigilo.vpchatillon.fr/generate_panel.php?token=QMWHHPRF

Catégories

La liste des catégories est accessible via l’url suivante

https://api.vigilo.vpchatillon.fr/get_categories_list.php

Chacune d’entre elles possède un identifiant qui pourra être utilisé pour filtrer les observations (voir plus loin)

Afficher plusieurs observations

Ainsi, pour afficher plusieurs observations, il est possible d’utiliser l’url suivante

https://api.vigilo.vpchatillon.fr/mosaic.php

Cette url affiche les photos de toutes les observations par ordre décroissant de soumission. Il est possible de filtrer les observations par catégorie en rajoutant le paramètre ?c=<id_de_categorie>. Exemple de l’url à utiliser pour afficher tous les aménagements mal conçus.

https://api.vigilo.vpchatillon.fr/mosaic.php?c=3

Extraction complète de la base de données

La base de données entière peut être extraite au format JSON avec l’url suivante.

https://api.vigilo.vpchatillon.fr/get_issues.php