icecondor:api
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
icecondor:api [2008/09/14 20:31] – 192.168.0.3 | icecondor:api [2024/01/31 04:08] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
=== web/SVG version === | === web/SVG version === | ||
- | http:// | + | http:// |
- | http:// | + | http:// |
=== Introduction === | === Introduction === | ||
Line 7: | Line 7: | ||
output format: JSON \\ | output format: JSON \\ | ||
success/ | success/ | ||
- | |||
- | 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: | ||
- | hdop = float (Dilution of Precision) \\ | ||
- | vdop = float \\ | ||
- | pdop = float \\ | ||
- | radius = error estimate (in meters) \\ | ||
=== IDs/URIs === | === IDs/URIs === | ||
- | When not using a lat/ | + | the id field in icecondor is a URI, with some standard URNs defined. |
- | urn:wifi: | + | A person is generally defined by their OpenID URL. |
- | urn: | + | < |
+ | http:// | ||
+ | </ | ||
+ | If there is no identified URL for the user, a regular uuid can be generated. | ||
+ | < | ||
+ | urn: | ||
+ | </ | ||
+ | |||
+ | |||
+ | 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: | ||
+ | urn: | ||
+ | </ | ||
=== Update location === | === Update location === | ||
Line 31: | Line 35: | ||
POST /locations | POST /locations | ||
input: | input: | ||
- | | + | |
+ | location[timestamp]=<2008-09-05T22: | ||
+ | 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 | ||
- | | + | |
output: | output: | ||
</ | </ | ||
Line 39: | Line 51: | ||
=== Search === | === Search === | ||
< | < | ||
- | GET /locations/< | + | GET /locations?id=< |
input: | input: | ||
search filters: | search filters: | ||
- | | + | |
- | | + | lat=< |
- | | + | long=< |
- | | + | alt=< |
+ | or | ||
+ | id=< | ||
+ | limit=< | ||
output: | output: | ||
returns the most recent post. | returns the most recent post. | ||
- | [id, | + | [id, |
</ | </ |
icecondor/api.1221424265.txt.gz · Last modified: 2024/01/31 04:08 (external edit)