FR:Servers/api.openstreetmap.fr

From OpenStreetMap Wiki
Jump to: navigation, search
Langues disponibles — Servers/api.openstreetmap.fr
· 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 · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 吴语 · 粵語 · 中文(繁體)‎ · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް
Contactez User:Sletuffe ou utilisez la page de discussion pour des questions concernant le serveur api.openstreetmap.fr. Pour signaler les anomalies/améliorations, vous pouvez ajouter un ticket sur Trac.

Cette page présente l'utilisation des API 0.6, XAPI et Overpass API présents sur api.openstreetmap.fr hébergé sur les serveurs de l'association OpenStreetMap France.

Notes générales

  • Utilisable par n'importe qui dans des logiciels tiers pour répartir la charge des autres serveurs qui fournissent ces API (priorité à la communauté OSM-FR ?)
  • Couverture mondiale
  • Aucune garantie de convenir à vos besoins, utilisez ces services à vos propres risques, il peut s'arrêter n'importe quand, etc.

Note : Si vous comptez appeler ces API avec un logiciel de votre cru qui risque de faire de nombreux appels, je vous recommande de passer le paramètre &contact=votre@email à votre requête (ce qui ne change rien au résultat vu que ce n'est pas pris en compte) ce qui me permettra de vous identifier dans les fichiers de logs du serveur. Ainsi, plutôt que de vous bannir comme un malpoli je pourrais prendre contact avec vous et trouver une solution plus équitable, en outre, je pourrais vous notifier de changements survenus (je ne promets rien).

Quasi-API 0.6

Présentation

Ce service d'API 0.6 permet d'accéder à une copie des données de la base openstreetmap mise à jour toutes les minutes. Il permet un accès alternatif en lecture des données et supporte la modification/ajout/suppression de donnée en transmettant la demande au serveur officiel d'openstreetmap.

Il peut donc être utilisé dans tout logiciel où serait habituellement utilisé le serveur officiel a condition que le logiciel permette de remplacer l'adresse du serveur officiel api.openstreetmap.org par api.openstreetmap.fr

Avantages

Son avantage est d'être plus rapide en général que le serveur officiel (qui est souvent très occupé) et donc de le soulager. Les limitations en zone de téléchargement et en nombre de téléchargement sont également moins restrictives et, de ce fait, il est particulièrement adapté pour les usages intensifs qui sont en général bannis du serveur officiel.

Utilisation dans des logiciels

Traitements automatisés

Si vous avez besoin d'accéder à beaucoup d'éléments pour du travail d'analyse, statistiques, etc. il est préférable de laisser le serveur officiel pour ne pas perturber le travail d'édition des contributeurs et donc d'utiliser ce type de service (ou #XAPI). (Notez toutefois que si vous souhaitez travailler à l'échelle d'un département ou plus, ça ne suffira sans doute pas et vous devriez utiliser des extraits de la base.)

Dans les éditeurs de données osm

Comme les données ne datent au plus que de quelques minutes, il est tout à fait possible d'utiliser cette API pour éditer avec JOSM, Merkaator ou d'autres logiciels d'édition. Vous pourrez télécharger de plus grandes zones ou plus d'objets depuis la base.

  • Pour l'utiliser dans JOSM : Menu des préférences (F12) -> paramètres de connexion

On rentre :

au lieu de

Rien d'autre n'est à changer, même pas login/mot de passe et on peut continuer comme d'habitude.

Limitations

Confidentialité

  • Lorsque vous rentrez des données, votre mot de passe transitera en clair par le serveur de l'association openstreetmap france (mais il n'est pas conservé)
  • Pas de support de Oauth

Appels re-transmis

Les appels concernant l'historique des objets, l'envoi ou la récupération de traces gps sont re-dirigés vers l'api officielle (http 301), il n'y a donc pas d'accélération et les mêmes limitations que celles de l'api officielle s'appliqueront à ce type d'appels.

Données légèrement plus vieilles

Les appels de lecture sont traités avec une copie de la base de donnée openstreetmap qui peut avoir quelques minutes de retard, cela peut donc produire des comportements un peu étrange. L'exemple le plus classique et que lorsque vous effectuez une modification sur des données, que vous envoyez vos modifications, puis que je vous re-téléchargez les données dans la foulée. Vous allez alors vous retrouver avec l'état d'avant votre modification.

La solution consiste à attendre un peu avant de re-télécharger, à travailler sur d'autres éléments ou une autre zone ou ne pas effacer votre copie locale des données qui elles sont à jour et qui peuvent donc être modifiées à nouveau puis ré-envoyées.

  • Un graphique indiquant le retard en minutes de cette base peut être surveillé ici : [1]

Comportements non conformes

Certains appels ne se comportent pas comme ceux de l'API officielle. Lorsque vous utilisez les appels de la forme /api/0.6/(nodes|ways|relations)?4567,456,789 si un des éléments a été supprimés précédemment cette API ne renvoie pas l'élément alors que l'API officielle le renvoie, mais avec le statut "visible=false" pour indiquer qu'il a été supprimé.

Pour la récupération des données, ça ne change pas grand chose, mais si vous éditer des données et que vous disposez d'une ancienne copie d'un élément qui a été supprimé depuis, en utilisant dans JOSM la fonction "mise à jour des données/de la sélection" l'élément supprimé ne sera pas retiré de votre copie.

Notez que le plugin d'annulation de JOSM crash dans certains cas à cause de cette limitation.

Si c'est votre cas, le plus simple et de remettre l'api officielle dans vos préférences, faire la mise à jour, puis remettre à nouveau api.openstreetmap.fr

Code source

XAPI

Le service api.openstreetmap.fr fourni l'api "XAPI" à l'adresse http://api.openstreetmap.fr/xapi?

(exemple : http://api.openstreetmap.fr/xapi?node[name=Paris]) Voir la documentation de XAPI Cet appel tente de se rapprocher au plus près de celle décrite ci-avant, tout particulièrement les informations nécessaires à l'édition comme les tags version, timestamp et user sont renvoyées.

Il fourni aussi

http://api.openstreetmap.fr/xapi-without-meta? (tel que fourni par le traducteur de l'OverpassAPI, c'est à dire que par défaut le fichier renvoyé est plus petit car ne contenant pas les informations nécessaire à l'édition, on peut toutefois ajouter le prédicat [@meta] pour les avoir, ce qui revient à l'accès ci-avant)
Explications sur le pourquoi de ces deux xapi

Overpass API

Autres format de sortie (en beta test)

Sortie en osm dont les ways/relations sont converti en noeuds

(Utilise osmconvert)

Sortie GPX

(Utilise osmconvert + convertisseur maison)

Code source

Autre serveur pour la France seulement

Service HS, manifestez vous si vous vous en serviez (et que vous avez l'énergie d'aider à le remettre en route)

A noter qu'il existe aussi l'adresse http://oapi-fr.openstreetmap.fr/ avec exactement les mêmes appels (API, XAPI et overpass API) mais sur la france métropolitaine (attention toutefois, on trouve des données des pays voisins car il y a un petit tampon pour être certain de tout avoir). Faites attention si vous voulez vous en servir pour éditer en bordure des frontières françaises, mais l'avantage c'est que ça va encore plus vite, et que si vous faites des appels sans BBOX, vous recevez alors presque uniquement des données en France.

Notez que cette API ne marche pas avec l'overpass-turbo, et je ne sais pas pourquoi.