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