User Tools

Site Tools


icecondor:api

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
icecondor:api [2008/09/14 20:43] 192.168.0.3icecondor:api [2024/01/31 04:08] (current) – external edit 127.0.0.1
Line 1: Line 1:
 === web/SVG version === === web/SVG version ===
-http://donpark.org/icecondor/doc/post.svg \\ +http://donpark.org/icecondor/doc/post.svg (currently out of date) \\ 
-http://donpark.org/icecondor/doc/search.svg+http://donpark.org/icecondor/doc/search.svg (currently out of date)
  
 === Introduction === === Introduction ===
Line 7: Line 7:
 output format: JSON \\  output format: JSON \\ 
 success/error reporting: HTTP response code \\ 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 === === IDs/URIs ===
Line 27: Line 17:
 </code> </code>
  
-If there is no identified URL for the user, a regular guid can be generated.+If there is no identified URL for the user, a regular uuid can be generated.
 <code> <code>
 urn:uuid:7a13feb0-829d-11dd-ad8b-0800200c9a66 urn:uuid:7a13feb0-829d-11dd-ad8b-0800200c9a66
Line 45: Line 35:
 POST /locations POST /locations
 input: input:
-  id=<idlat=<xlong=<yalt=<ztime=<wHDOP=<hdopVDOP=<vdopPDOP=<pdop>+  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   or
-  id=<id> next_to=<other id> radius=<in meters>+  location[guid]=<openid urllocation[next_to]=<other guidlocation[radius]=<in meters> (unimplemented)
 output: output:
 </code> </code>
Line 53: Line 51:
 === Search === === Search ===
 <code> <code>
-GET /locations/<guid>+GET /locations?id=<guid>
 input: input:
   search filters:   search filters:
-  radius=<radius> - return the last record for any ids in the radius +    radius=<radius> - return the last record for any ids in the radius 
-   lat=<lat> +    lat=<lat> - center the search on this lat/long 
-   long=<long> +    long=<long> 
-   alt=<alt> (optional)+    alt=<alt> (optional) 
 +   or 
 +    id=<id> - center the search on the last location for this id 
 +    limit=<count>
 output: output:
   returns the most recent post.   returns the most recent post.
-  [id,lat,long,alt,time,hdop,vdop,pdop]+  [id,lat,long,alt,time,radius]
  
 </code> </code>
icecondor/api.1221425031.txt.gz · Last modified: 2024/01/31 04:08 (external edit)