Documentatie/Create-Taskmap.md

Create taskmap

The user can use the "ItemTask" API to execute the TaskmapTask with the cropfield item code in {code}.
{itemCode} should contain the item with tiff data.

~! REMEMBER, creating a taskmap with a high resolution < 1 can take a considerable time (from minutes up to hours). !~ ~! It helps to lower the precision to say 1 or 0 if a high resolution is needed. !~

Request

POST /api/v1/items/{code}/tasks
{  
  "taskType": "vnd.farmmaps.task.taskmap"  
}

Response 201

{
  "code": "string",
  "taskType": "vnd.farmmaps.task.taskmap",
  "attributes": {
    "inputCode" "{itemCode}"
    "operation": "shape", // currently only "shape" supported
    "cellWidth": "10", // in metres
    "cellHeight": "5", // in metres
	"startPoint": "{
		\"type\": \"Point\",
		\"coordinates\": [6.014414493084948, 53.08996024180022]
    }",
    "endPoint": "{
		\"type\": \"Point\",
		\"coordinates\": [6.014997043859679, 53.090253715796308]
    }"
  }
}

• geojson is expected in WGS84, 4326 projection.
• endPoint is optional but angle or endPoint is needed!

Response 400 Tasktype not found
Response 401 Not authenticated
Response 403 No WRITE permissions in item
Response 404 Item not found

This will create the item with shape data as a sibling of the input item.

Optional input parameters

There are some optional task attribute input parameters for greater flexibility.

• inputLayerName
  Allows you to specify which layer to use for an input item.
• precision default value of 2 decimals. Caps the values to {precision} decimals after the .
• endPoint geojson geometry. (endpoint or angle is needed!) point geometry
• angle value between 0.0 - 360.0. (endpoint or angle is needed!) Orientation of the taskmap fishnet.
• centered true or false. centers the abline in the middle of the 'cellWidth' axis.

Default percentile values for nbs are 0.0 and 1.0.

{
    "inputLayerName": "customLayerName",
    "precision": 2,
    "angle": 45,
    "centered": "true",
    "endPoint": "{
		\"type\": \"Point\",
		\"coordinates\": [6.014997043859679, 53.090253715796308]
    }"
}