FR:Osmose/api/0.2
L'API 0.2 d'Osmose est disponible à l'adresse : http://osmose.openstreetmap.fr/api/0.2/ . D'une façon générale l'api retourne du JSON.
Paramètres
Détail des paramètres utilisés par les requêtes sur l'API. Tous les paramètres ne sont pas disponibles pour toutes les requêtes.
| Param | Type | Défaut | Commentaire |
|---|---|---|---|
| lat | flottant | Latitude de départ. | |
| lon | flottant | Longitude de départ. | |
| bbox | lon1,lat1,lon2,lat2 | Restriction de zone. | |
| item | 1000,1010,1020,2xxx | Tout | Liste des items à retourner, un nombre suivi de "xxx" pour avoir une catégorie complète. Voir la liste http://osmose.openstreetmap.fr/fr/api/0.2/meta/items |
| source | entier | Numéro de la source, voir la liste des sources http://osmose.openstreetmap.fr/fr/control/update | |
| class | entier | Classe de l'item, une ou plusieurs classes séparées par des virgules, une classe est une sous-partie d'un item. N'a de sens qu'avec un item unique. | |
| username | Nom d'un utilisateur OSM, retourne les erreurs portant sur les objets dont l'utilisateur est le dernier éditeur. | ||
| level | liste de 1, 2 ou 3 | 1,2,3 | Niveau des erreurs. Liste des chiffres 1, 2, et/ou 3 dans l'ordre. |
| full | false ou true | false | Détail des erreurs |
| zoom | entier | 10 | Niveau de zoom |
| limit | entier | 100 | Nombre d'erreurs retournées, 500 maximum. |
| country | Région des erreurs. Le joker "*" est autorisé comme partie du paramètre, par exemple "france*" pour toutes les régions à la fois. Voir la liste http://osmose.openstreetmap.fr/fr/api/0.2/meta/countries | ||
| useDevItem | true, false or all | false | Retourner des erreurs uniquement pour les items non actifs de mise au point ou buggué. |
| status | open, done, false | open | Statut des erreurs, "open" pour erreur en cours, "done" pour erreur reportée comme corrigée et "false" pour celle reportée en faux positif. |
| start_date | date | Prend en compte les erreurs générées après cette date. Pour les statistiques commence à cette date. Date au format "Y[-m[-d]]". | |
| end_date | date | Prend en compte les erreurs générées avant cette date. Pour les statistiques termine à cette date. Date au format "Y[-m[-d]]". | |
| tags | t1,t2,t3 | Filtre les erreurs suivant une liste de tags de leurs items. Les tags sont des thématiques d'analyses, pas des tags OSM. La liste des tags http://osmose.openstreetmap.fr/fr/api/0.2/meta/tags | |
| fixables | online or josm | Retourne uniquement les erreurs qui ont une proposition de correction utilisable avec l'éditeur d'Osmose en ligne ou JOSM. |
meta
Cette partie de l'API ne traite pas des erreurs mais de la classification de celles-ci, elle ne supporte pas de paramètres.
| URL | Param | Description |
|---|---|---|
| /meta/categories | Listes des catégories d'items avec le détail des items : nom, level et nombre d'erreur. | |
| /meta/countries | Liste des régions supportées par Osmose. | |
| /meta/items | Liste des items avec les traductions disponibles. | |
| /meta/tags | Liste des tags permettant de filtrer les erreurs via leur item. |
error
La partie centrale de l'API, permet d'obtenir des erreurs.
| URL | Param | Description |
|---|---|---|
| /error/ID | Détail d'une erreur. ID est un entier. | |
| /error/ID/done /error/ID/false | Change le statut de l'erreur. La passe en corrigé (done) ou en faux-positif (false). ID est un entier. | |
| /error/ID/fix | Obtient la première proposition de correction possible. ID est un entier. | |
| /error/ID/fix/IDF | Obtient une proposition de correction possible. ID et IDF sont des entiers. IDF est l'index de la proposition et commence à 0. | |
| /errors | lat, lon, bbox, item, source, class, username, level, full, limit, country, useDevItem, status, tags, fixable | Liste les erreurs suivant les paramètres. |
user
Erreur par utilisateur, seul le dernier contributeur de l'objet fautif est signalé, même s'il n'est pas à l'origine de l'erreur.
| URL | Param | Description |
|---|---|---|
| /api/0.2/user/USERNAME | bbox, item, source, class, level, limit, country, useDevItem, status, tags, fixable | Liste des erreurs de l'utilisateur suivant les paramètres. USERNAME est un nom d'utilisateur OSM. |
| /api/0.2/user_count/USERNAME | bbox, item, source, class, level, limit, country, useDevItem, status, tags, fixable | Comptage d'erreur pour un utilisateur suivant les paramètres. |
| /api/0.2/users | bbox, item, source, class, level, limit, country, useDevItem, status, tags, fixable | Comptage d'erreur par utilisateur suivant les paramètres. |