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