文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 仿真场景/ 获取场景详情
更新时间：2025-09-22 GMT+08:00
查看PDF
分享

获取场景详情

功能介绍

获取场景详情。

URI

GET /v2/{project_id}/sim/sm/scenarios/{id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参见获取项目ID

id

是

String

场景ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

url

String

场景资源地址

id

Integer

场景ID

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

labels

Array of LabelBriefSrlz objects

场景标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计

gen_scenario

String

泛化场景资源地址

road_scenario

String

路采场景资源地址

description

description object

描述

file

FileNestedSrlz object

场景文件信息

map

map object

场景地图信息

model

model object

场景模型信息

simulator

String

仿真器，如：B

version

String

场景对应的OpenSCENARIO版本

filename

String

场景文件名称

map_filename

String

场景地图文件名称

model_filename

String

场景模型文件名称

user_id

String

用户ID

user_name

String

用户名称

name

String

场景名称

priority

Integer

优先级,取值越大，优先级越高。可从如下范围中选择：

  • 120 – S：至关重要
  • 100 – A：很重要
  • 80 – B：重要
  • 60 – C：普通

status

Integer

状态信息：

  • 0 - Released 已发布
  • 1 - Available 可用
  • 10 - Initial 初始化中
  • 11 - Unavailable 不可用
  • 12 - Releasing 发布中
  • 100 - Deprecated 已弃用

source

String

来源，如 UPLOAD - 用户上传
表4 LabelBriefSrlz

参数

参数类型

描述

name

String

场景标签名称

url

String

场景标签资源地址

id

Integer

场景标签ID

family

Integer
  • 0 - Customized
  • 1 - Odd China
  • 2 - Open Odd
  • 3 - Odd Nhtsa
  • 4 - Open Label

root

Long

场景标签所在标签树的根标签ID

tag_type

String

场景标签所属标签树名称

parent_names

Array of objects

父标签名称
表5 description

参数

参数类型

描述

content

String

描述的内容
表6 map

参数

参数类型

描述

url

String

地图资源地址

id

Integer

地图ID

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

file

FileNestedSrlz object

地图文件信息

version

String

地图版本

  • v1.4.0 - v1.4.0
  • v1.5.0 - v1.5.0
  • v1.6.0 - v1.6.0
  • v1.6.1 - v1.6.1
  • v1.7.0 - v1.7.0

agreement_confirm

Boolean

协议确认

true - 同意

false - 不同意
表7 model

参数

参数类型

描述

url

String

模型资源地址

id

Integer

模型ID

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

file

FileNestedSrlz object

模型文件信息

format

String

模型文件格式

  • osgb - osgb
  • fbx - fbx

agreement_confirm

Boolean

协议确认

true - 同意

false - 不同意
表8 FileNestedSrlz

参数

参数类型

描述

url

String

文件资源地址

sha256

String

文件SHA256 信息

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

path

String

文件路径信息

bucket

String

bucket信息

filename

String

文件名称

ready

Boolean

文件状态。完成文件上传状态为true，未完成文件上传状态为false

请求示例

获取场景详情

GET https://{endpoint}/v2/{project_id}/sim/sm/scenarios/32050

响应示例

状态码：200

{
	"url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/",
	"id": 32050,
	"created_at": 1742353268.604604,
	"updated_at": 1742353269.253803,
	"labels": [
	],
	"gen_scenario": null,
	"road_scenario": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/road-scenarios/865/",
	"description": {
		"content": ""
	},
	"file": {
		"url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/files/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898/",
		"sha256": "d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898",
		"created_at": 1742353268.593741,
		"updated_at": 1742353269.144296,
		"path": "sim/ifiles/scenario/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898.xosc",
		"bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf",
		"filename": "scenario_1742353244.xosc",
		"ready": true
	},
	"map": {
		"url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/",
		"id": 21668,
		"created_at": 1742353260.93824,
		"updated_at": 1744074022.312378,
		"file": {
			"url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/files/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203/",
			"sha256": "15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203",
			"created_at": 1742353260.934919,
			"updated_at": 1742353261.36653,
			"path": "sim/ifiles/map/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203.xodr",
			"bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf",
			"filename": "road.xodr",
			"ready": true
		},
		"version": "v1.5.0",
		"agreement_confirm": true
	},
	"model": null,
	"simulator": "B",
	"version": "v0.9.1",
	"filename": "scenario_174xxx244.xosc",
	"map_filename": "road.xodr",
	"model_filename": null,
	"user_id": "5ffa2cb7631340xxxxx4736284af7dc4",
	"user_name": "octopus_admin",
	"source": "UPLOAD",
	"name": "sc_7BgqxxxxuKCKwYw",
	"priority": 60,
	"status": 0
}

状态码

状态码

描述

200

请求成功

错误码

请参见错误码。

父主题： 仿真场景

相关文档