文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 仿真场景/ 创建仿真场景
更新时间：2025-06-24 GMT+08:00
查看PDF
分享

创建仿真场景

功能介绍

该接口用于创建基于OpenSCENARIO标准的仿真场景。支持OpenSCENARIO 0.9.1 - 1.1.1 版本的场景。

URI

POST https://{hostURL}/v2/{project_id}/sim/sm/scenarios

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

gen_scenario

否

String

泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。

description

是

MutableFileSrlz object

描述的内容。

file

否

file object

仿真场景文件，场景文件为OpenSCENARIO格式。

simulator

是

String

仿真器，如B。

version

是

String

场景对应的OpenSCENARIO版本。

map_filename

否

String

地图文件名称，地图文件为OpenDRIVE格式。

model_filename

否

String

地图文件所关联的3D模型文件名称，当前支持OSGB格式。

user_id

否

String

用户id。

user_name

否

String

用户名。

name

是

String

场景名称。

priority

否

Integer

  • 120 - S

  • 100 - A

  • 80 - B

  • 60 - C

  • 40 - D

map

否

String

场景地图资源地址。

model

否

String

场景3D模型资源地址。

source

否

String

  • UPLOAD - User upload scenario.

  • ROAD - Road scenario.

  • GENERALIZATION - Generalized scenario.

  • BUILT_IN - Built-in scenario.
表3 MutableFileSrlz

参数

是否必选

参数类型

描述

content

是

String

描述的内容。
表4 file

参数

是否必选

参数类型

描述

sha256

是

String

文件sha256值。

filename

是

String

文件名。

响应参数

状态码：201

表5 响应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

MutableFileSrlz object

描述的内容。

file

file object

仿真场景文件，场景文件为OpenSCENARIO格式。

simulator

String

仿真器，如B。

version

String

场景对应的OpenSCENARIO版本。

map_filename

String

地图文件名称，地图文件为OpenDRIVE格式。

model_filename

String

地图文件所关联的3D模型文件名称，当前支持OSGB格式。

user_id

String

用户id。

user_name

String

用户名。

name

String

场景名称。

priority

Integer

  • 120 - S

  • 100 - A

  • 80 - B

  • 60 - C

  • 40 - D

map

String

场景地图资源地址。

model

String

场景3D模型资源地址。

source

String

  • UPLOAD - User upload scenario.

  • ROAD - Road scenario.

  • GENERALIZATION - Generalized scenario.

  • BUILT_IN - Built-in scenario.
表6 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

父标签名称。
表7 MutableFileSrlz

参数

参数类型

描述

content

String

描述的内容。
表8 file

参数

参数类型

描述

url

String

文件资源地址。

sha256

String

文件sha256值。

created_at

TimeStamp

创建时间。

updated_at

TimeStamp

更新时间。

post

post object

POST预签链接信息，用于上传文件。

put_url

String

PUT预签链接地址，用于上传文件。优先使用POST方法上传。

get_url

String

GET地址，用于下载文件。

expire

Integer

默认失效时间为600秒。

ready

Boolean

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

filename

String

文件名。
表9 post

参数

参数类型

描述

url

String

POST预签链接信息，用于上传文件。

fields

PostResponseField object

POST预签链接信息，调用POST预签链接上传文件时用于构造请求。
表10 PostResponseField

参数

参数类型

描述

key

String

Post预签链接Key字段，在创建请求时需要添加到请求头。

x-amz-algorithm

String

Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。

x-amz-credential

String

Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。

x-amz-date

String

Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。

policy

String

Post预签链接policy字段，在创建请求时需要添加到请求头。

x-amz-signature

String

Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求示例

创建仿真场景

POST https://{endpoint}/v2/{project_id}/sim/sm/scenarios/

{
  "name" : "my-scenario",
  "simulator" : "B",
  "priority" : 40,
  "description" : {
    "content" : "scenario description"
  },
  "version" : "v1.1.1",
  "map" : "/v2/my_projectid/sim/sm/maps/2631662/",
  "map_filename" : "ALKS_Road_straight.xodr",
  "source" : "UPLOAD"
}

响应示例

状态码：201

请求成功

{
  "url" : "/v2/my_project_id/sim/sm/scenarios/361/",
  "id" : 361,
  "created_at" : 1.699954029362022E9,
  "updated_at" : 1.699954029362044E9,
  "labels" : [ ],
  "gen_scenario" : null,
  "road_scenario" : null,
  "description" : {
    "content" : "scenario description"
  },
  "file" : null,
  "simulator" : "B",
  "version" : "v1.1.1",
  "map_filename" : "ALKS_Road_straight.xodr",
  "model_filename" : null,
  "user_id" : "userId",
  "user_name" : "userName",
  "name" : "my-scenario",
  "priority" : 40,
  "map" : "/v2/my_project_id/sim/sm/maps/2631662/",
  "model" : null,
  "source" : "UPLOAD"
}

状态码

状态码

描述

201

请求成功

错误码

请参见错误码。

父主题： 仿真场景

相关文档