Outils pour utilisateurs

Outils du site


wiki:projets:smartphone-geiger:api

API d'accès aux mesures

Maintenant que nos utilisateurs peuvent remplir notre base de donnée, nous avons besoins d'un moyen d'y accéder efficacement. Pour cela, nous mettons à disposition des internautes une api simple.

Dans notre première version nous pouvions récupérer toutes les entrées de la base de donnée en nous rendant sur l'url : https://open_geiger-c9-chsimon.c9.io/ . Mais bien que cela marche très bien pour l'instant, il faut imaginer le temps de chargement pour une base de donnée contenant plus de 100 000 entrées.

Nous devons donc permettre à l'utilisateur d'affiner sa recherche avant de lui renvoyer les résultats.

Ce qui nous donne 3 types d'url :

Sélection par coordonnées GPS seules

Chaque mesure est caractérisée par son emplacement donné en coordonnées GPS.

https://open_geiger-c9-chsimon.c9.io/mesures/<latitude_min>/<longitude_min>/<latitude_max>/<longitude_max>

Exemple : https://open_geiger-c9-chsimon.c9.io/mesures/48.847790330523644/2.356945277130573/48.847790330523644/2.356945277130573

Sélection par plage horaire seule

Pour sélectionner toutes les mesures prises durant une période donnée, il suffit de spécifier le timestamp de l'instant de début et celui de l'instant de fin. Un timestamp est un entier représentant le nombre de secondes écoulées depuis le 1er janvier 1970. On trouve des convertisseurs un peu partout sur le net, exemple ici : http://www.unixtimestamp.com/index.php .

https://open_geiger-c9-chsimon.c9.io/mesures/<timestamp_min>/<timestamp_max>

Exemple : https://open_geiger-c9-chsimon.c9.io/mesures/1400609400638/1400664742948

Sélection par coordonnées GPS et plage horaire

Il s'agit d'une combinaison des urls précédentes. Nous recommandons d'utiliser cette version.

https://open_geiger-c9-chsimon.c9.io/mesures/<latitude_min>/<longitude_min>/<latitude_max>/<longitude_max>/<timestamp_min>/<timestamp_max>

Exemple : https://open_geiger-c9-chsimon.c9.io/mesures/48.847790330523644/2.356945277130573/48.847790330523644/2.356945277130573/1400609400638/1400664742948

wiki/projets/smartphone-geiger/api.txt · Dernière modification: 2016/09/11 13:15 (modification externe)