API

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 Framework instead.

Contents 1 REST Specifications for the Editing API 2 Instances 3 Implementations and Scripting 4 Terms of use 5 Summaries of Editing API Changes 6 Links

REST Specifications for the Editing API

• API v0.6 - (currently used, as of April 2009)
• API v0.5 (no longer used) though this document may still be of use
• API v0.4 (no longer used)
• API v0.3 (no longer used)

We are labeling wiki pages {{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 Develop/Frameworks.

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.

Scripted imports and automated edits should only be carried out by those with experience and understanding of the way the OpenStreetMap community create maps, and only with careful planning and consultation. See Import/Guidelines and Automated Edits/Code of Conduct

Summaries of Editing API Changes

• API changes between v0.5 and v0.6
• API changes between v0.4 and v0.5
• API changes between v0.3 and v0.4

Links

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