[OSM-talk-fr] Le service sur api.openstreetmap.fr s'agrandi lui aussi

[Vincent Pottier]

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)<liste at 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