[OSM-dev] 0.4 OSM API Documentation

michael_j at email.de michael_j at email.de
Fri May 25 22:50:57 BST 2007

to the list:

> ranaldo at unina.it wrote:

> 1) Methods to retrieve gps points seems to be missing (url =
>     trackpoints?bbox=bllon,bllat,trlon,trlat&page=0).

The OSM 0.3 reference had specified the following command:

    *  url = trackpoints?bbox=bllon,bllat,trlon,trlat&page=0 

    "Gets the track points uploaded by various users. It will provide a list of track points, paged, given 
    some bounding box where bllat is the bottom-left latitude, trlon is the top-right longitude and so on. 
    Each page (page goes like 0, 1, 2...) contains 5,000 track points. Currently there is no way to find 
    how many pages there are in total and the newer points are on the early pages. "

Currently the documentation of the OSM 0.4 version does not contain any equivalent command. 

What is the equivalent command and its parameters for 0.4 version? Are the trackpoints still downloaded in pages of 5000  trackpoints.

> 2) downloading a big area resolves in a error, is it the same downloading
>     a small area with a very huge way crossing it?

May someone knowing the answers please let us know. :-)


> -----Ursprüngliche Nachricht-----
> Von: michael_j at email.de
> Gesendet: 23.05.07 23:58:06
> An: dev at openstreetmap.org
> Betreff: [OSM-dev] 0.4 OSM API Documentation

> Hello, 
> on Essen developers workshop we started updating the Wiki based specification of the OSM 0.4 API. I send this message to provide a status update and warmly encourage contributions. 
> After looking on the used REST protocol in detail, it became evident that splitting the existing API specification into separate specifications for the involved protocol layers would avoid duplicated documentation and improve the understanding. Thus this route had been taken.
> As now a name was needed for the upper protocol layer containing the OSM specific commands and response information, the name  'OSM Application Protocol' or just 'OSM Protocol' had been chosen.
> So far the following had been specified:
> OSM Application Layer:
> + the commands (e.g. "Create new way", "Get map" )
> + the parameters of the commands
> + the data types of the parameters
> + for each command the applicable error codes and their meaning
> HTTP Layer:
> + the methods (GET, PUT and DELETE)
> + the error codes (e.g. Status Code "OK", "Not Found", ..)
> The following is still missing:
> OSM Application Layer:
> + for each command a short description:
>   - of its purpose
>   - of  its actions
> + the description of the XML-payload transported in the message bodies (XML-Schema,  etc.)
> + Examples 
> The specifications are found here:
> http://wiki.openstreetmap.org/index.php/REST
> Also it is worth to mention, that a protocol feature request page had been created. It is used to propose and discuss new protocol features:
> http://wiki.openstreetmap.org/index.php/OSM_V0.4/Protocol_Feature_Proposals
> In order to complete the information found there, please tell us you needs:
> - What are you looking for that is currently missing?
> - What can be improved?
> Cheers,
> Michael
> _______________________________________________
> dev mailing list
> dev at openstreetmap.org
> http://lists.openstreetmap.org/cgi-bin/mailman/listinfo/dev

More information about the dev mailing list