Download OpenAPI specification:Download
Solorrow API - you can also explore it using SwaggerUI
(developer-friendly) here
Request a new field map in an asynchronous process. Field maps are classified in 5 classes by default. Since the process is asynchronous, the response will contain the field_map_request_id
and a location
header with URL value which can be used to check the status of your request.
You can use the field_map_request_id
to check the status of your request, if you provide a notification_url
in your request then we will send a notification to this url once the field map generation is finished with the following data.
boundary required | object This requires a field boundary in GeoJSON format. |
notification_url | string This is a URL where the Solorrow system will send a notification to once the processing of your request is finished. |
field_map_type_id required | integer Value: 1 Type of field map (currently we only support field potential map which is type is |
numberOfClasses | integer <int32> [ 2 .. 10 ] number of classes for the classification |
The field map request is submitted successfully and is now in process
Invalid data provided
Unauthorized authentication token
The supplied boundary contains errors (gaps or overlapping lines)
{- "field_map_request_id": "00000000-0000-0000-0000-000000000000"
}
Check the status of field map request
field_map_request_id required | string <uuid> Example: 00000000-0000-0000-0000-000000000000 field map request ID to check it |
The work is in-progress
location to get the field map.
Invalid data provided
Unauthorized authentication token
Field map request not found
{- "message": "string"
}
get the field map
field_map_id required | string <uuid> Example: 00000000-0000-0000-0000-000000000000 field map ID to get |
successful operation
Invalid data provided
Unauthorized authentication token
Field map not found
{- "features": [
- {
- "type": "Feature",
- "id": 0,
- "geometry": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Point"
}
]
}, - "properties": { }
}
], - "type": "FeatureCollection",
- "histogram": {
- "1": 0,
- "2": 0,
- "3": 0,
- "4": 0,
- "5": 0
}, - "pixel_size": 0,
- "number_of_classes": 0,
- "classes_step": 0,
- "areas": {
- "1": 0,
- "2": 0,
- "3": 0,
- "4": 0,
- "5": 0
}
}
Use this endpoint for re-classifying an field map. You can choose any number of classes within the range 2-10. Since the process is asynchronous, the response will contain the classification_request_id
and a location
header with URL value which can be used to check the status of your request.
You can use the classification_request_id
to check the status of your request, if you provide a notification_url
in your request then we will send a notification to this url once the reclassification of the application map is finished with the following data.
field_map_id required | string <uuid> Example: 00000000-0000-0000-0000-000000000000 field map ID to reclassify |
numberOfClasses required | integer <int32> [ 2 .. 10 ] number of classes for the reclassification |
notification_url | string This is a URL where the Solorrow system will send a notification to once processing the request is finished. |
Reclassification is now in processing
Invalid data provided
Unauthorized authentication token
Field map Not Found
{- "classification_request_id": "00000000-0000-0000-0000-000000000000"
}
Check the status of field map classification request
field_map_id required | string |
classification_request_id required | string |
The work is in-progress
location to get the field map classification.
Invalid data provided
Unauthorized authentication token
Field map or classification request not found
{- "message": "string"
}
get the field map classification
field_map_id required | string |
classification_id required | string |
successful operation
Invalid data provided
Unauthorized authentication token
Field map or classification not found
{- "features": [
- {
- "type": "Feature",
- "id": 0,
- "geometry": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Point"
}
]
}, - "properties": { }
}
], - "type": "FeatureCollection",
- "histogram": {
- "1": 0,
- "2": 0,
- "3": 0,
- "4": 0,
- "5": 0
}, - "pixel_size": 0,
- "number_of_classes": 0,
- "classes_step": 0,
- "areas": {
- "1": 0,
- "2": 0,
- "3": 0,
- "4": 0,
- "5": 0
}
}
This endpoint can be used to get an field map in formats for the use in machines and for printing. The file is a ZIP file which contains a PDF report
, Taskdata XML (ISOBUS)
and a Shape
file. Example: here. Since the process is asynchronous, the response will contain a location
URL which you can use to check the status of the request. After finishing generating the TaskData file, we will send it to the notification_url
that provided in your request with a zip file.
field_map_id required | string <uuid> Example: 00000000-0000-0000-0000-000000000000 field map ID to get its task data |
customer_id required | integer <int32> |
customer_name required | string |
crop_name required | string |
machine_name required | string Enum: "spreader" "sprayer" "driller" "rowseeder" |
field_id required | integer |
field_name required | string |
unit required | string Enum: "kg/ha" "l/ha" "dt/ha" "seeds/ha" |
does_rates required | ZonesDoesRates (object) or CalculateDoesRates (object) |
language | string Default: "eng" Enum: "eng" "fr" "de" "ro" Language to use when generating the report file. |
notification_url | string This is a URL where the Solorrow system will send a request to which contains the ZIP file once the processing of the request is finished. |
Generating task data file is now in process
Invalid data provided
Unauthorized authentication token
Field map not found
{- "taskdata_request_id": "00000000-0000-0000-0000-000000000000"
}
Check the status of taskdata request
field_map_id required | string |
taskdata_request_id required | string |
The work is in-progress
location to get the Taskdata files.
Invalid data provided
Unauthorized authentication token
Field map or taskdata request not found
{- "message": "string"
}
get the task data zip file
field-map-id required | string |
taskdata-id required | string |
successful operation
Invalid data provided
Unauthorized authentication token
Field map or taskdata not found
{- "message": "string"
}