=== web/SVG version ===
http://donpark.org/icecondor/doc/post.svg (currently out of date) \\
http://donpark.org/icecondor/doc/search.svg (currently out of date)

=== Introduction ===
input format: HTTP get/post variables \\
output format: JSON \\ 
success/error reporting: HTTP response code \\

=== IDs/URIs ===

the id field in icecondor is a URI, with some standard URNs defined. 

A person is generally defined by their OpenID URL.
<code>
http://openid_server/username
</code>

If there is no identified URL for the user, a regular uuid can be generated.
<code>
urn:uuid:7a13feb0-829d-11dd-ad8b-0800200c9a66
</code>


The follow URNs are used to build an icecondor id when the MAC address of a wifi access point or a bluetooth device are known.

<code>
urn:wifi:00:11:22:33:44:55
urn:bluetooth:00:11:22:33:44:55
</code>

=== Update location ===

<code>
POST /locations
input:
  client[version]="YYYYMMDD"
  location[timestamp]=<2008-09-05T22:00+0000 (ISO8601)> 
  location[guid]=<openid url> 
  location[latitude]=<float> 
  location[longitude]=<float> 
  location[altitude]=<altitude in meters>
  location[accuracy]=<horizontal accuracy in meters>
  location[velocity]=<speed in meters/s>
  location[heading]=<direction in degrees>
  or
  location[guid]=<openid url> location[next_to]=<other guid> location[radius]=<in meters> (unimplemented)
output:
</code>

=== Search ===
<code>
GET /locations?id=<guid>
input:
  search filters:
    radius=<radius> - return the last record for any ids in the radius
    lat=<lat> - center the search on this lat/long
    long=<long>
    alt=<alt> (optional)
   or
    id=<id> - center the search on the last location for this id
    limit=<count>
output:
  returns the most recent post.
  [id,lat,long,alt,time,radius]

</code>