Servers/api.openstreetmap.fr

From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — Servers/api.openstreetmap.fr
· English · français

The api.openstreetmap.fr web service hosts an API 0.6, XAPI et Overpass API. It is hosted on a server from the french "openstreetmap France". You can contact User:Sletuffe or the talk page for questions.

For bugs or suggestions, you can open a ticket on [1]

Almost-API 0.6

Introduction

This Almost-API 0.6 service allows you to access a copy of the openstreetmap data updated every minute. It allows an accelerated read access and supports modification/addition/deletion of data by forwarding your requests to the official server at api.openstreetmap.org (acting as a proxy).

It can be used everywhere the official API could be used as long as the software permits to change the URL from api.openstreetmap.org to api.openstreetmap.fr

Advantages

It is generaly faster than the official API server and can be used to reduce the load on it. Its download area size and max number of objects are larger so that it can be used for intensive usage that is generally not recommended or is forbidden on the official API server.

How/when can you use it

Mechanical operations

If you need an access to several elements for analysis, statistics, etc.. It is recommended to avoid using the official API to avoid slowing down other contributors's work of editing and use instead some other services for that purpose, like this service if you want API 0.6 compatibilty (or XAPI or Overpass_API for other APIs). However note that if you wish to work for large areas (like hundreds of kilometers wide) that API won't help and you should work with base extracts

In an openstreetmap editor

Since datas are only a few minutes late, it is also possible to use this API to edit with JOSM or Merkaator or even other edition software. Advantages being that this API allows you to download wider areas and/or more objects that the official API would.

  • To use in JOSM : Presets (F12) -> "Connexion paramèters"

Write :

instead of the default

Nothing else changes, you can use same login/password as before (your osm account)

Limitations

Privacy

  • Your user and password are transmitted plain text (well, like the official API) but do transit through our server, (however, the password isn't stored)
  • No Oauth support

Proxied requests

Requests concerning history of objects and gps tracks are forwarded (HTTP 301) directly to the official API, no acceleration is performed and same limits as the official API apply.

Data a little older

Read calls are answered with a local database copy of openstreetmap, and can be a few minutes late (typically 1 to 2 minutes), this can lead to strange behaviour you have to be aware of : If you are modifying data in some place, upload your changes and delete you JOSM date layers + re-download the data right-away, you'll have the old version of your modifications.

What you should do in that case is keep the data in your editor if you wish to modify it again, or work on another area or wait 1 or 2 minutes.

  • Here you can see how late the local data is : [2]

Requests not compliant with the API specs

Some calls don't react like the official API : when using calls like /api/0.6/(nodes|ways|relations)?4567,456,789 if one of the element was deleted, this api doesn't return anything while the official API returns it with the attribut "visible=false" to express the fact it was deleted.

For data download, it doesn't matter much, but if you have kept a local version of an osm file in which elements where deleted since, after using JOSM's action "update data/selection" the now suppressed element will still appear in your local copy.

Note that the reverter plugin of JOSM will crash, in some cases due to this limitation.

If you have kept such a local copy of old data that you want to "update", you should switch back to the official API in your settings, then update your local data, then switch back to api.openstreetmap.fr Link title

code

XAPI

The api.openstreetmap.fr service also provide a "XAPI". Address being : http://api.openstreetmap.fr/xapi?

(example : http://api.openstreetmap.fr/xapi?node[name=London]) See XAPI documentation

There also is a "reduced API" at

http://api.openstreetmap.fr/xapi-without-meta? (Like the XAPI provided by the OverpassAPI, it sends smaller files and quicker (attributs necessary for edition are not returned unless you add [@meta] to your query, and in that case it does react like the previous)
Explications sur le pourquoi de ces deux xapi

Overpass API

note : This Overpass installation is in version 7.4 and support area queries

Converted Output (still in beta tests)

Output to osm where ways/relations are converted to nodes

(This uses osmconvert)

Output to GPX

(This uses osmconvert + home made converter)

Code

Global notes

  • Usable by anyone
  • World wide coverage
  • Not guaranteed to suit your needs, use at your own risks, can stop anytimes, etc.

Note : If you plan to call those API with your own software doing lots of mechanical calls, please add &contact=your@email at the end of your queries. (It doesn't change the result since it isn't taken into account) But I'll be able to contact you to find a solution in case of problems like overload instead of banning you like an ass hole (no promises however).