Appearance
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
json
{
"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 |
| status | Integer | Task status: 0-init, 1-running, 2-success, 3-failed |
| total | Integer | Number of result plans |
| content | List<MarketProgrammingSimulationResult> | Simulation result plans (ordered by row_index) |
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
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 Code | Description |
|---|---|
| 200 | Success |
| 400 | Request parameter error |
| 401 | Unauthorized |
| 500 | Server internal error |
Usage Instructions
- This API is used to query simulation results by the
taskNoreturned from create simulation API - When
statusis 0 or 1, results may be incomplete; poll until status is 2 (success) or 3 (failed) - Use
content[].idasresultIdwhen calling create order from simulation API
Notes
- Results are ordered by
rowIndex - When status is 2, use one or more
content[].idvalues to create programming orders via/market/order/programming/createFromSimulation