API

From OpenStreetMap Wiki
Jump to navigation Jump to search

OpenStreetMap has an editing API for fetching and saving raw geodata from/to the OpenStreetMap database — this is the entry page for the documentation. If you just want to embed a map into a webpage, you don't want this API. Use a web map library instead. Alternatively, consider the Overpass API which provides read-only API access.

REST specifications for the editing API

  • API v0.6 - (currently used, as of April 2009 including multiple minor changes afterwards)
  • API v0.5 (no longer used as of April 2009); though this document may still be of use
  • API v0.4 (no longer used as of October 2007)
  • API v0.3 (no longer used as of May 2007)

Wiki pages are labelled with {{Not 0.6 compatible}} if they describe something which does not, or may not work with the 0.6 API version.

Instances

See Databases and data access APIs

Implementations and scripting

The current full serverside implementation is the Rails port.

For other uses, see Software libraries.

Terms of use

The editing API is provided in order to edit the map data, not for read-only purposes or projects. Clients may be blocked without notice if they are affecting the service level for others or causing data corruption. See our API usage policy.

exclamation mark

Imports and automated edits should only be carried out by those with experience and understanding of the way the OpenStreetMap community creates maps, and only with careful planning and consultation with the local community.
See Import/Guidelines and Automated Edits code of conduct for more information. Imports/automated edits which do not follow these guidelines might be reverted!

Summaries of editing API changes

Links

  • API v0.7 - Brainstorming for the next version of the OSM API