Skip to content

Beds & Plants Endpoints#

Overview#

Name HTTP URL
Query beds of a garden GET /companies/{company_id:int}/gardens/{garden_id:int}/beds
Query plants of a bed GET /companies/{company_id:int}/gardens/{garden_id:int}/beds/{bed_id:int}/plants

Query beds of a garden#

Accepts an empty GET request and returns a streamed json response as seen below with information about the beds in the specified garden. The values are averaged from all the plants in the bed.

For the plant coordinates to be calculated, the server needs to have the pointclouds available. If a pointcloud is not available, those coordinates will be omitted and the pointcloud will be scheduled to be downloaded in the background as soon as possible.

Info

Due to the large amount of data that needs to be queried for this endpoint, a lot of gRPC requests need to be made to the SEEREP server, which might take a while.

For 6 beds with 33 plants each, over 600 gRPC requests need to be send, which may take ~20 seconds, during which the response is streamed back.

Request: GET /companies/{company_id:int}/gardens/{garden_id:int}/beds
Response: 200 Ok, 404 Not Found

Example response (Beds are streamed one by one):

{
 "id": 1,
 "plant": "mangold",
 "variety": "Lucullus",
 "plants": "http://localhost:8000/companies/1/gardens/1/beds/1/plants",
 "soil_humidty": 0.65,
 "harvest": "6 week",
 "yield": 451.1587423100285,
 "health": [
  {
   "type": "water",
   "loglevel": 1
  },
  {
   "type": "nutrients",
   "loglevel": 1
  },
  {
   "type": "diseases",
   "loglevel": 1
  }
 ],
 "plant_coords": [
  {
   "lat": 52.317118374885005,
   "lon": 7.630641577424838
  },
  {
   "lat": 52.317126563936476,
   "lon": 7.63064192673892
  },
  {
   "lat": 52.31712302636109,
   "lon": 7.630644944039591
  },
  {
   "lat": 52.31711997964676,
   "lon": 7.63064731009461
  },
  {
   "lat": 52.31712704329051,
   "lon": 7.63063668011326
  }
 ]
}

Query plants of a bed#

Accepts an empty GET request and returns a json response with information about the individual plants in the specified bed. As seen below, the response looks similar to the one from the beds endpoint above, but these values are per plant and not averages.

Request: GET /companies/{company_id:int}/gardens/{garden_id:int}/beds/{bed_id:int}/plants
Response: 200 Ok, 404 Not Found

Example response:

{
 "plants": [
  {
   "id": "25816c5842f14fe98b1ebc85a4908934",
   "bedid": 1,
   "plant": "mangold",
   "variety": "Lucullus",
   "soil_humidty": 0.0,
   "harvest": "11 week",
   "yield": 486.50339525240184,
   "health": [
    {
     "type": "water",
     "loglevel": 1
    },
    {
     "type": "nutrients",
     "loglevel": 1
    },
    {
     "type": "diseases",
     "loglevel": 2
    }
   ],
   "plant_coords": {
    "lat": 52.317118374885005,
    "lon": 7.630641577424838
   }
  },
  {
   "id": "5107b0de17984b038b4319ad431c9775",
   "bedid": 1,
   "plant": "weed",
   "variety": "Lucullus",
   "soil_humidty": 0.0,
   "harvest": "0 week",
   "yield": 324.1666937668429,
   "health": [
    {
     "type": "water",
     "loglevel": 1
    },
    {
     "type": "nutrients",
     "loglevel": 1
    },
    {
     "type": "diseases",
     "loglevel": 1
    }
   ],
   "plant_coords": {
    "lat": 52.317126563936476,
    "lon": 7.63064192673892
   }
  }
 ]
}