Query Programming Simulation Results

API Information

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

Request Headers

Parameter	Type	Required	Description
Authorization	String	No	User authentication token (optional for this query)
Content-Type	String	Yes	Must be set to application/json

Request Body Structure

Field	Type	Required	Description	Constraints
taskNo	String	Yes	Simulation task unique identifier	Returned from simulation create API

Request Body Example

{
  "taskNo": "SIM_20260307_xxxx"
}

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	SimulationResultQueryResp	Response data

SimulationResultQueryResp Object

Field	Type	Description
taskNo	String	Simulation task unique identifier
name	String	Simulation task target name
status	Integer	Task status: 0-init, 1-running, 2-success, 3-failed
failedReason	String	Failure reason when status is failed
total	Integer	Number of result plans
geometry	String	Original request geometry JSON
orderNo	String	Related order number (if available)
outputFolderId	Long	Related output folder id (if available)
ossOutputId	Long	Related OSS output config id (if available)
outputFolderName	String	Output folder display path (if available)
ossOutputName	String	OSS output config name (if available)
ossConnection	OssOutputListItemResp	OSS connection info without AK/SK (if available)
content	List<MarketProgrammingSimulationResult>	Simulation result plans (ordered by rowIndex)

OssOutputListItemResp Object

Field	Type	Description
id	Long	OSS config id
name	String	OSS config name
storageType	String	Storage type
endPoint	String	Object storage endpoint
bucket	String	Bucket name
folderPath	String	Folder path
accessPath	String	Base access path
ctime	Long	Create timestamp (seconds)
mtime	Long	Update timestamp (seconds)

MarketProgrammingSimulationResult Object (content item)

Field	Type	Description
id	Long	Result record id (use as resultId when creating order from simulation)
taskNo	String	Associated simulation task no
rowIndex	Integer	Plan row index (0-based)
satName	String	Satellite name
satId	String	Satellite id
trackDirection	String	Track direction L/R
startTime	String	Pass start time
stopTime	String	Pass end time
duration	String	Pass duration
direction	String	Pass direction A/D
active	String	Active flag
optimalTime	String	Optimal time
optimalAng	BigDecimal	Optimal angle
centerLat	String	Center latitude
centerLon	String	Center longitude
thisCoverage	String	Current pass coverage
currentCoverage	String	Accumulated coverage
absCoverage	String	Absolute coverage
allSwathLonLat	String	Swath lon/lat JSON
region	String	Region geometry JSON
area	BigDecimal	Area (km²), optional

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "taskNo": "SIM_20260307_xxxx",
    "name": "preview_ORDER_202604090001",
    "status": 2,
    "failedReason": null,
    "total": 1,
    "geometry": "{\"type\":\"Polygon\",\"coordinates\":[...]}",
    "orderNo": "ORDER_202604090001",
    "outputFolderId": 20,
    "ossOutputId": 5,
    "outputFolderName": "/root/path/market/output",
    "ossOutputName": "obs-prod",
    "ossConnection": {
      "id": 5,
      "name": "obs-prod",
      "storageType": "OBS",
      "endPoint": "obs.cn-xxx.myhuaweicloud.com",
      "bucket": "market",
      "folderPath": "/output",
      "accessPath": "https://example.com",
      "accessRelativePath": "/market/output",
      "ctime": 1718000000,
      "mtime": 1718000000
    },
    "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

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

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
500	Server 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