Skip to content

Query Analysis Detail V2 API

API Information

  • Request Path: /analysis/task/query/detailV2
  • Request Method: GET
  • Content-Type: application/json

Request Headers

ParameterTypeRequiredDescription
AuthorizationStringYesUser authentication token

Request Parameters

ParameterTypeRequiredDescriptionConstraints
idLongYesTask IDMust be a valid task ID

Parameter Example

/analysis/task/query/detailV2?id=12345

Response Body Structure

CommonResponse Object

FieldTypeDescription
codeIntegerResponse status code
messageStringResponse message
dataAnalysisTaskDetailV2Analysis task detail V2 response

AnalysisTaskDetailV2 Object

FieldTypeDescription
idLongTask ID
taskNameStringTask name
taskStatusIntegerTask status (2=Progressing, 3=Complete, 4=Failed)
ctimeLongCreate time
mtimeLongModified time
durationLongTask duration (ms)
metaDataIdLongMetadata ID
taskItemsList<AnalysisTaskItemDetail>List of task result items

AnalysisTaskItemDetail Object (Nested in AnalysisTaskDetailV2)

FieldTypeDescription
idLongMetadata ID
algorithmNameStringAlgorithm name
taskIdStringSub Task ID
statusIntegerSub Task status (2=Progressing, 3=Complete, 4=Failed)
layerStringLayer Name
numStringAnalysis result count
totalAreaStringAnalysis result total area
colorStringResult style (color)
fillOpaFloatfill opacity
strokeStringstroke color
strokeOpaFloatstroke opacity
strokeWtFloatstroke width
analysisResultAnalysisResultRespAnalysis result

AnalysisResultResp Object (Nested in AnalysisTaskItemDetail)

FieldTypeDescription
algorithmCodeStringAlgorithm code
stageStringStage: waiting/pre process/process/post process/publishing/completed/failed
progressDoubleProgress Percentage
dataPublishVectorRespAnalysis result data

PublishVectorResp Object (Nested in AnalysisResultResp)

FieldTypeDescription
layerStringLayer name
storeStringStore name
workspaceStringWorkspace name
wfsVectorProtocWFS result
wmsVectorProtocWMS result
wmtsVectorProtocWMTS result

VectorProtoc Object (Nested in PublishVectorResp)

FieldTypeDescription
defaultFormatStringDefault format
supportFormatList<String>Support formats
uriStringResource URI

Response Examples

Success Response

json
{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 215,
        "taskName": "TEST_API_TASK",
        "thumbnail": null,
        "taskStatus": 3,
        "ctime": 1763951470,
        "mtime": 1763952620,
        "duration": 1150,
        "metaDataId": 406,
        "taskItems": [
            {
                "id": 217,
                "algorithmName": "Building",
                "taskId": "1992787813702561793",
                "status": 3,
                "num": 20,
                "totalArea": 31385.300227568678,
                "color": "#E95757",
                "analysisResult": {
                    "algorithmCode": "neu_extract_building_segmentation",
                    "geometryType": "polygon",
                    "data": {
                        "layer": "aiibghghacgzbefagic",
                        "store": "aiibghghacgzbefagic",
                        "wfs": {
                            "defaultFormat": "application/json",
                            "supportFormat": [
                                "application/json",
                                "SHAPE-ZIP",
                                "application/vnd.google-earth.kml+xml"
                            ],
                            "uri": "https://eo.origen.ae/geoserver/default_workspace/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=aiibghghacgzbefagic"
                        },
                        "wms": {
                            "defaultFormat": "image/png",
                            "supportFormat": [
                                "image/png",
                                "image/jpeg"
                            ],
                            "uri": "https://eo.origen.ae/geoserver/default_workspace/wms?service=WMS&request=GetMap&version=1.1.0&layers=aiibghghacgzbefagic&styles=&srs=EPSG:4326"
                        },
                        "wmts": {
                            "defaultFormat": "image/png",
                            "supportFormat": [
                                "image/png",
                                "image/jpeg"
                            ],
                            "uri": "https://eo.origen.ae/geoserver/default_workspace/gwc/service/wmts?Service=WMTS&Request=GetTile&version=1.0.0&layer=aiibghghacgzbefagic&styles=&tilematrixset=EPSG:4326"
                        },
                        "workspace": "default_workspace"
                    },
                    "elements": [
                        {
                            "num": 20,
                            "totalArea": 31385.300227568678,
                            "category": "Buildings",
                            "categoryName": null,
                            "color": "#E95757",
                            "fillOpa": 0.8,
                            "stroke": "#FFFFFF",
                            "strokeOpa": 0.8,
                            "strokeWt": 1.0
                        }
                    ]
                }
            }
        ]
    }
}

Failure Response

json
{
    "code": 404,
    "message": "Task not found",
    "data": null
}

Error Code Description

Error CodeDescription
200Success
400Request parameter error
401Unauthorized
404Task not found
500Server internal error

Usage Instructions

  1. This API is used to query detailed information about a specific analysis task (V2 version)
  2. User authentication is required
  3. Task ID must be provided as query parameter
  4. Returns enhanced task information including execution logs and thumbnails

Notes

  • Task ID is required and must be a valid task ID
  • Enhanced version with additional information like execution logs
  • User authentication token must be included in request headers