FR:Osmose/api/0.2

From OpenStreetMap Wiki
Jump to: navigation, search
Langues disponibles — Osmose/api/0.2
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Baso Minangkabau · bosanski · brezhoneg · català · čeština · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · português do Brasil · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 吴语 · 粵語 · 中文(繁體)‎ · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް

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 flotant Latitude de départ.
lon flotant Longitude de départ.
bbox lon1,lat1,lon2,lat2 Restriction de zone.
item 1000,1010,1020,2xxx Tout Liste des items à retourner, un nombre suivit 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 Classes de l'item, une ou plusieurs classes séparées par des virgules, une classe est une sous partie d'un item. N'as 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 autoriser 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 Statu des erreurs, "open" pour erreur en cours, "done" pour erreur reporté comme corrigée et "false" pour celle reportée en faux positif.

Error status, open for error stil reported, done for error reported as corrected, false for error report as false positive.

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'un erreur. ID est un entier.
/error/ID/done /error/ID/false Change le status 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 proportion 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.