Observation

POST - Create

Create an observation


URI:

/observation

METHOD:

POST

PARAMETERS:

orbis
	structure:		(string)
	length:			(3 - 250)
	validate		required | hashtags | Comments

gps_lat
	structure:		(decimal)
	length:			(-90.00000000 <-> 90.00000000)
	validate		required | gps:latitude
	
gps_lon
	structure:		(decimal)
	length:			(-180.00000000 <-> 180.00000000)
	validate		required | gps:longitude

RETURN:

{
	"success": true,
	"reasons": [
		{
			"code": "C-O-create-00",
			"message": "success"
		}
	],
	"results": {
		"tag": {
			"id": 9,
			"label": "label_name",
			"created_at": "2016-06-25 23:37:43",
			"updated_at": "2016-06-25 23:37:43",
			"deleted_at": null
		},
		"observation": {
			"user_id": 1,
			"tag_id": 9,
			"gps_key": 125.7,
			"gps_lat": -90.00000000,
			"gps_lon": 180.00000000,
			"created_at": {
				"date": "2016-07-18 12:26:48",
				"timezone_type": 3,
				"timezone": "UTC"
			},
			"id": 8382303
		}
	}
}

GET - Lookup

Lookup observations


URI:

/observation/{gps_lat}/{gps_lon}/{tag}

METHOD:

GET

PARAMETERS:

tags
	structure:		(string)
	length:			(3 - 100)
	validate		required | space_separated_tags | comma_separated_tags

gps_lat
	structure:		(decimal)
	length:			(-90.00000000 <-> 90.00000000)
	validate		required | gps:latitude
	
gps_lon
	structure:		(decimal)
	length:			(-180.00000000 <-> 180.00000000)
	validate		required | gps:longitude

RETURN:

{
	"success": true,
	"reasons": [
		{
			"code": "C-O-lookup-00",
			"message": "success"
		}
	],
	"results": {
		"tag": null,
		"epi": {
			"lat": 0.00000000,
			"lon": 0.00000000
		},
		"observations": [
			{
				"id": 8382303,
				"tag_id": "9",
				"gps_lat": "-90.00000000",
				"gps_lon": "180.00000000",
				"distance": "0.49194341048621226"
			},
			{
				"id": 8382302,
				"tag_id": "9",
				"gps_lat": "90.00000000",
				"gps_lon": "-180.00000000",
				"distance": "0.1879980672843791"
			}
			{...}
		]
	}
}