Le 28/03/2012 11:42, sly (sylvain letuffe) a écrit :
Le mercredi 28 mars 2012 10:33:32, Pieren a écrit :
2012/3/27 sly (sylvain letuffe)<li...@letuffe.org>:
Soyons fou, et commençons à faire que cette api fr soit plus pointue que
l'officielle (je changerais si ça perturbe trop ou j'en ferais une
deuxième) j'envoi maintenant 3 niveaux (c'est les soldes)
Il y a un très grand danger à modifier le comportement de l'API
original. Ca n'est plus du proxy; ça altère le comportement des
logiciels clients suivant qu'ils utiliseront l'API original ou
celui-là.
La déviance est lié au sens que l'on donne à "API original"
API (Application Programming Interface) c'est d'abord des spécifications
destinées à être utilisées... par le serveur et par le client (d'après [1]).
http://gnagna/api/ c'est un serveur offrant une interface plus ou moins
conforme à ces spécifications.
Selon moi, l'api 0.6 n'a qu'une documentation valable, c'est celle-ci :
http://wiki.openstreetmap.org/wiki/API_0.6
En fait, la question est de savoir si la doc du wiki est une
spécification de l'api 0.6 ou une documentation de l'interface
osm.org/api/0.6
En fait, ça doit être un peu les deux...
Et mon proxy s'efforce de s'y référer au plus prêt possible. Seulement l'api de
osm.org ne suit pas exactement cette documentation [1] non plus, il y a donc 3
choix :
- en rester à la documentation
- mimiquer les déviances de l'api officielle
- prendre des libertés quand l'api officielle prend des libertés
[1] exemple :
Retrieving map data by bounding box: GET /api/0.6/map
(...)
* All relations that reference one of the nodes or ways included due to
the above rules. (Does not apply recursively.)
Alors qu'en fait, c'est récursif mais une fois, ce qui est contraire à la
documentation
Au minimum, il faudrait la renommer en autre chose
+1, api.fr => "frapi" avant d'entri :-)
Peut-être que c'est la spécification qu'il faudrait enrichir, tout en
s'y tenant...
La spec dit " pas récursif... le résultat devrait être conforme.
On ajoute du vocabulaire à la requête : .../full pour avoir de la
récursivité.
Quoi qu'il en soit du comportement actuel de l'api fr, je propose de ne pas en
recommander son usage à un public trop large. Le cercle des gens bien à l'aise
avec JOSM, qui comprennent ce qu'est une relation, qui save ce qu'est un
conflit et qui suive cette liste de manière régulière : ok.
Et qui sont au courant de la latence de 2 mn.
[1] http://en.wikipedia.org/wiki/Application_programming_interface
--
FrViPofm
_______________________________________________
Talk-fr mailing list
Talk-fr@openstreetmap.org
http://lists.openstreetmap.org/listinfo/talk-fr
