Skip to content

Query Programming Simulation Results

API Information

  • Request Path: /market/order/programming/simulation/results
  • Request Method: POST
  • Content-Type: application/json

Request Headers

ParameterTypeRequiredDescription
AuthorizationStringNoUser authentication token (optional for this query)
Content-TypeStringYesMust be set to application/json

Request Body Structure

FieldTypeRequiredDescriptionConstraints
taskNoStringYesSimulation task unique identifierReturned from simulation create API

Request Body Example

json
{
  "taskNo": "SIM_20260307_xxxx"
}

Response Body Structure

CommonResponse Object

FieldTypeDescription
codeIntegerResponse status code
messageStringResponse message
dataSimulationResultQueryRespResponse data

SimulationResultQueryResp Object

FieldTypeDescription
taskNoStringSimulation task unique identifier
statusIntegerTask status: 0-init, 1-running, 2-success, 3-failed
totalIntegerNumber of result plans
contentList<MarketProgrammingSimulationResult>Simulation result plans (ordered by row_index)

MarketProgrammingSimulationResult Object (content item)

FieldTypeDescription
idLongResult record id (use as resultId when creating order from simulation)
taskNoStringAssociated simulation task no
rowIndexIntegerPlan row index (0-based)
satNameStringSatellite name
satIdStringSatellite id
trackDirectionStringTrack direction L/R
startTimeStringPass start time
stopTimeStringPass end time
durationStringPass duration
directionStringPass direction A/D
activeStringActive flag
optimalTimeStringOptimal time
optimalAngBigDecimalOptimal angle
centerLatStringCenter latitude
centerLonStringCenter longitude
thisCoverageStringCurrent pass coverage
currentCoverageStringAccumulated coverage
absCoverageStringAbsolute coverage
allSwathLonLatStringSwath lon/lat JSON
regionStringRegion geometry JSON
areaBigDecimalArea (km²), optional

Response Examples

Success Response

json
{
  "code": 200,
  "message": "success",
  "data": {
    "taskNo": "SIM_20260307_xxxx",
    "status": 2,
    "total": 1,
    "content": [
      {
        "id": 123,
        "taskNo": "SIM_20260307_xxxx",
        "rowIndex": 0,
        "satName": "TY-CSAR-2",
        "satId": "1",
        "trackDirection": "L",
        "startTime": "2026-03-08T03:10:46.762",
        "stopTime": "2026-03-08T03:11:41.152",
        "duration": "54.39",
        "direction": "D",
        "active": "1",
        "optimalTime": null,
        "optimalAng": null,
        "centerLat": "20.0295",
        "centerLon": "105.748",
        "thisCoverage": "0.056061",
        "currentCoverage": "0.056061",
        "absCoverage": "0.056061",
        "allSwathLonLat": "[[[106.2305,21.50806],...]]",
        "region": "{\"type\":\"Polygon\",\"coordinates\":[...]}",
        "area": 626.25
      }
    ]
  }
}

Failure Response

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

Error Code Description

Error CodeDescription
200Success
400Request parameter error
401Unauthorized
500Server internal error

Usage Instructions

  1. This API is used to query simulation results by the taskNo returned from create simulation API
  2. When status is 0 or 1, results may be incomplete; poll until status is 2 (success) or 3 (failed)
  3. Use content[].id as resultId when calling create order from simulation API

Notes

  • Results are ordered by rowIndex
  • When status is 2, use one or more content[].id values to create programming orders via /market/order/programming/createFromSimulation