Osmose/api/0.2 - Other languages
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.
|
