FarmMaps/Documentatie
8
0
Fork 0
Code Pull Requests Releases Activity

Update 'Create-Taskmap.md'

Browse Source
This commit is contained in:
Mark van der Wal 2021-02-10 19:15:23 +00:00
parent 43aaad44ec
commit ae07a10e7e
1 changed files with 73 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
Create-Taskmap.md
View File

@ -1,5 +1,9 @@
## Create taskmap ## Create taskmap
The user can use the "ItemTask" API to execute the TaskmapTask with the item code which contains the tiff data in {code}. 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 > Request
```javascript ```javascript
@ -13,14 +17,24 @@ POST /api/v1/items/{code}/tasks
{ {
"code": "string", "code": "string",
"taskType": "vnd.farmmaps.task.taskmap", "taskType": "vnd.farmmaps.task.taskmap",
"delay": "",
"attributes": { "attributes": {
"additionalProp1": "string", "inputCode" "{itemCode}"
"additionalProp2": "string", "operation": "shape", // currently only "shape" supported
"additionalProp3": "string" "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 400 Tasktype not found
Response 401 Not authenticated Response 401 Not authenticated
@ -28,3 +42,32 @@ Response 403 No WRITE permissions in item
Response 404 Item not found Response 404 Item not found
This will create the item with shape data as a sibling of the input item. 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.
```javascript
{
"inputLayerName": "customLayerName",
"precision": 2,
"angle": 45,
"centered": "true",
"endPoint": "{
\"type\": \"Point\",
\"coordinates\": [6.014997043859679, 53.090253715796308]
}"
}
```