创建仿真场景-CreateSimulationScenario

功能介绍

该接口用于创建基于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"
}