Don Park

This is an old revision of the document!

web/SVG version

http://donpark.org/icecondor/doc/post.svg
http://donpark.org/icecondor/doc/search.svg

Introduction

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

id = Any unique string identifier (usually a URI)
lat = signed float (in degrees)
long = signed float (in degrees)
alt = signed float (in meters)
time = 2008-09-05T22:00Z (ISO8601)
hdop = float (Dilution of Precision)
vdop = float
pdop = float
radius = error estimate (in meters)

IDs/URIs

When not using a lat/long/alt, a location can be specified by reference to an existing or non-existing icecondor object. the id field in icecondor is a URI, with some standard URNs defined. 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.

urn:wifi:00:11:22:33:44:55
urn:bluetooth:00:11:22:33:44:55

Update location

POST /locations
input:
  id=<id> lat=<x> long=<y> alt=<z> time=<w> HDOP=<hdop> VDOP=<vdop> PDOP=<pdop>
  or
  id=<id> next_to=<other id> radius=<in meters>
output:

Search

GET /locations/<guid>
input:
  search filters:
  radius=<radius> - return the last record for any ids in the radius
   lat=<lat>
   long=<long>
   alt=<alt> (optional)
output:
  returns the most recent post.
  [id,lat,long,alt,time,hdop,vdop,pdop]

**This is an old revision of the document!**