[OSM-talk] API 0.3 deployed

SteveC steve at asklater.com
Mon Mar 13 15:58:37 GMT 2006


Hello

API 0.3 is now live, and 0.2 is there too. 0.2 will be phased out within
a few weeks and is only there to allow editor authors to catch up with
the new API.

0.3 supports things like:

'ways' - ordered lists of segments to make streets etc
'areas' -  same as above but makes things like buildings and lakes
history - you can now get the history for every object, complete or
          bounded by some time frame you want
map-at - you can ask for map data as it was at some point in the past,
         eg the map api now accepts a time field
gzip - everything is now gzip-encoded if your http client asks for it,
       not just the map api
tags - the server now treats tags 'properly'. That is, they have their
       special XML (so no more arbitrary string). In the database they
       are still a string for nodes and segments. For ways and areas
       the tags have their own proper table. The nodes/seg schema
       will be updated to this in api 0.4, however as far as a client is
       concerned the XML is the same across the board.
id     No more 'uid' in any XML
new    No more newnode and newsegment, they're rolled in to the mail
       object requests.

The applet has been updated to point at the new API and handle the new
XML and includes all of imi's updates. It currently does not support
ways and areas.

There is documentation of all this on the wiki REST page.

Undoubtedly there will be bugs, please mail the dev list with them.

One request that didn't make it was a 'changed since' api to get data
since the last map request. Expect this with API 0.4, and please throw
any 0.4 requests on the REST wiki page... I doubt it'll take as long to
get to 0.4 as it did from 0.2 to 0.3.

have fun,

SteveC steve at asklater.com http://www.asklater.com/steve/




More information about the talk mailing list