4 资源服务接口文档

SimOne Web Asset Server

4.1 资源接口

4.1.1 获取资源列表

Path： /api-asset/assets

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
schema	query	资源类型 Enum: "vehicleModel" , "trafficflow" , "sensor" , "judgement" , "dynamics" , "controller"	No	string
category	query	目录id	No	string
vehicleOnly	query	为”true”时，只获取主车编辑器页面使用的资源	No	string

返回数据

Code	说明	类型
200	Ok	AssetList

4.1.2 创建资源

Path： /api-asset/assets

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	data ：资源数据； sourceId ：当资源包含文件时，已上传的文件名称（md5）； overwriteId ：如果传值将覆盖这个已存在的资源	No	{ “data” : Asset , “sourceId” : string, “overwriteId” : string }

返回数据

Code	说明	类型
200	Ok	AssetBaseResponse

---

4.1.3 获取指定资源

Path： /api-asset/assets/{id}

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	需要获取资源 id	Yes	string

返回数据

Code	说明	类型
200	Ok	Asset

4.1.4 修改资源

Path： /api-asset/assets/{id}

Method： PUT

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	需要更新的资源 id	Yes	string
requestBody	body	请求体	Yes	AssetSaveRequest

返回数据

Code	说明	类型
200	Ok	AssetBaseResponse

4.1.5 删除资源

Path： /api-asset/assets/{id}

Method： DELETE

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	要删除的资源 id	Yes	string

返回数据

Code	说明	类型
200	Ok	AssetBaseResponse

---

4.1.6 资源判重

Path： /api-asset/assets/isrepeat

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	AssetIsRepeatRequest

返回数据

Code	说明	类型
200	Ok	IsRepeatResponse

---

4.1.7 克隆资源

Path： /api-asset/assets/{id}/clone

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	要克隆资源的 id	Yes	string

返回数据

Code	说明	类型
200	Ok	AssetBaseResponse

---

4.2 案例接口

4.2.1 创建案例

Path： /api-asset/cases

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseCreateRequest extends PartialCaseDef

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.2.2 已完成任务另存为案例

Path： /api-asset/cases/vr

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseCreateRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.2.3 更新案例

Path： /api-asset/cases/update

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseSaveRequest

返回数据

Code	说明	类型
200	Ok	CaseSaveResponse

---

4.2.4 克隆案例

Path： /api-asset/cases/clone

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseCloneRequest

返回数据

Code	说明	类型
200	Ok	CaseCloneResponse

---

4.2.5 移动案例

Path： /api-asset/cases/move

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseMoveRequest

返回数据

Code	说明	类型
200	Ok	CaseMoveResponse

---

4.2.6 导出案例

Path： /api-asset/cases/export

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseExportRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.2.7 导入案例

Path： /api-asset/cases/import

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CaseImportRequest

返回数据

Code	说明	类型
200	Ok	CaseImportResponse

---

4.2.8 获取传感器数量超载的案例

Path： /api-asset/cases/checkSensors

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CheckSensorsRequest

返回数据

Code	说明	类型
200	Ok	[ { “id” : string, “name” : string } ]

---

4.2.9 删除案例

Path： /api-case/cases/trash

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	{ “ids” : [string] }

返回数据

Code	说明	类型
204 or 200	Ok	{}

---

4.3 地图接口

4.3.1 创建地图 / 更新地图

Path： /api-asset/maps

Method： POST

Headers： FormDataHeaders

请求参数

参数名称	传参格式	说明	是否必填	类型
formdata	body	请求体	Yes	MapCreateRequest

返回数据

Code	说明	类型
200	Ok	object

---

4.4 文件接口

4.4.1 上传文件

Path： /api-asset/files/{md5}/upload

Method： POST

Headers： FormDataHeaders

请求参数

参数名称	传参格式	说明	是否必填	类型
md5	path	文件 md5	Yes	string
raw	query	为”true”时表示上传的是数据驱动源	Yes	string
formData	body	请求体	Yes	FileUploadRequest

返回数据

Code	说明	类型
200	Ok	{ “code” : double }

---

4.4.2 替换指定目录下的文件

Path： /api-asset/files/replace

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
sourceId	query	文件名称	Yes	string
targetId	query	案例 id or 主车模型 id	Yes	string
category	query	资源类型 Enum: "case" , "vehicleModel"	Yes	string

返回数据

Code	说明	类型
200	Ok	{ “code” : double }

---

4.5 主车接口

4.5.1 获取主车列表

Path： /api-asset/vehicles

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
page	query	页码	No	string
pageSize	query	每页数量	No	string
search	query	搜索关键字	No	string

返回数据

Code	说明	类型
200	Ok	BasePageResponseVehicleList

4.5.2 创建主车

Path： /api-asset/vehicles

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	VehicleCreateRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.5.3 获取指定主车

Path： /api-asset/vehicles/{id}/vehicle

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	主车 id	Yes	string

返回数据

Code	说明	类型
200	Ok	VehicleItem

---

4.5.4 更新主车

Path： /api-asset/vehicles/{id}

Method： PUT

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	VehicleSaveRequest

返回数据

Code	说明	类型
200	Ok	VehicleSaveResponse

4.5.5 删除主车

Path： /api-asset/vehicles/{id}

Method： DELETE

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	删除的主车 id	Yes	string

返回数据

Code	说明	类型
200	Ok	object

---

4.5.6 判断主车是否重复

Path： /api-asset/vehicles/isrepeat

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	IsRepeatRequest

返回数据

Code	说明	类型
200	Ok	IsRepeatResponse

---

4.5.7 克隆主车

Path： /api-asset/vehicles/{id}/clone

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	主车id	Yes	string

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.5.8 更新主车资源文件

Path： /api-asset/vehicles/{vehicleId}/files

Method： POST

Headers： FormDataHeaders

请求参数

参数名称	传参格式	说明	是否必填	类型
vehicleId	path	主车id	Yes	string
formData	body	请求体	Yes	VehicleReplaceRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

Header

---

4.5.9 获取主车数量

Path： /api-asset/vehicles/count

Method： GET

Headers： Headers

请求参数

无

返回数据

Code	说明	类型
200	Ok	{ “count” : double }

---

4.5.10 导入主车

Path： /api-asset/vehicles/import

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	VehiclesCreateRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.6 测试集接口

4.6.1 获取测试集列表

Path： /api-asset/suites

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
opponent	query	案例类型 Enum: "openscenario"	Yes	string

返回数据

Code	说明	类型
200	Ok	SuiteList

4.6.2 创建测试集

Path： /api-asset/suites

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	SuiteCreateRequest

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.6.3 获取测试集

Path： /api-asset/suites/{id}

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	测试集id	Yes	string

返回数据

Code	说明	类型
200	Ok	Suite

4.6.4 更新测试集

Path： /api-asset/suites/{id}

Method： PUT

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	测试集id	Yes	string
requestBody	body	请求体	Yes	SuiteSaveRequest

返回数据

Code	说明	类型
200	Ok	SuiteSaveResponse

4.6.5 删除测试集

Path： /api-asset/suites/{id}

Method： DELETE

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	测试集id	Yes	string
opponent	query	案例类型 Enum: "openscenario"	No	string

返回数据

Code	说明	类型
200	Ok	GeneralResponse

---

4.6.6 移动测试集

Path： /api-asset/suites/move

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	CategoryMoveRequest

返回数据

Code	说明	类型
200	Ok	{}

---

4.6.7 测试集判重

Path： /api-asset/suites/isrepeat

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	IsRepeatRequest

返回数据

Code	说明	类型
200	Ok	IsRepeatResponse

---

4.7 页面目录接口

4.7.1 获取目录列表

Path： /api-asset/categories

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
pageType	query	页面类型 Enum: "assets" , "case" , "vehicle" , "judgeAsset"	Yes	string

返回数据

Code	说明	类型
200	Ok	AssetList

---

4.8 对手元素接口

4.8.1 获取对手元素列表

Path： /api-asset/obstacles

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
schema	query	Enum: "dynamic" , "static" 障碍物类型,指定 category 时可以不传	Yes	string
category	query	目录 id	Yes	string
page	query	页码	No	string
pageSize	query	每页数量	No	string
search	query	搜索关键字	No	string

返回数据

Code	说明	类型
200	Ok	BasePageResponseObstacleNpcArray

4.8.2 创建自定义对手元素

Path： /api-asset/obstacles

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	ObstacleCreateRequest

返回数据

Code	说明	类型
200	Ok	{ “npc” : ObstacleNpc }

---

4.8.3 获取指定对手元素

Path： /api-asset/obstacles/{id}

Method： GET

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	对手元素id	Yes	string

返回数据

Code	说明	类型
200	Ok	{ “npc” : ObstacleNpc }

4.8.4 更新对手元素

Path： /api-asset/obstacles/{id}

Method： PUT

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	对手元素id	Yes	string
requestBody	body	请求体	Yes	ObstacleCreateRequest

返回数据

Code	说明	类型
200	Ok	{ “npc” : ObstacleNpc }

4.8.5 删除自定义元素

Path： /api-asset/obstacles/{id}

Method： DELETE

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
id	path	需要删除元素的 id	Yes	string

返回数据

Code	说明	类型
200	Ok	{ “id” : string, “schema” : string }

---

4.8.6 对手元素判重

Path： /api-asset/obstacles/isrepeat

Method： POST

Headers： Headers

请求参数

参数名称	传参格式	说明	是否必填	类型
requestBody	body	请求体	Yes	{ “name” : string; “id” ?: string }

返回数据

Code	说明	类型
200	Ok	IsRepeatResponse

---

通用请求头

Headers

名称	类型	说明	是否必填
Authorization	string	用于权限验证的 token	Yes
accept	application/json	客户端接收JSON数据	No

FormDataHeaders

名称	类型	说明	是否必填
Authorization	string	用于权限验证的 token	Yes
Content-Type	multipart/form-data	客户端发送的数据类型	Yes
accept	application/json	客户端接收JSON数据	No

相关类型

4.1 资源接口相关类型

AssetList

系统资源列表

Record<string, [ Asset ]>

Asset

资源

名称	类型	说明	是否必填
id	string	ID	Yes
name	string	名称	Yes
userId	string	用户id	Yes
schema	string	类型	Yes
category	string	目录	Yes
thumbnail	string	缩略图文件路径	No
builtIn	boolean	是否内置	No
external	boolean	是否是外挂元素	No

PartialAsset

Partial< Asset >

表示 Asset 的每个键值对都是可选的

AssetBaseResponse

返回资源的响应

名称	类型	说明	是否必填
data	Asset	资源数据	Yes

AssetSaveRequest

修改资源的请求体

名称	类型	说明	是否必填
data	PartialAsset	更新的资源的数据	Yes
sourceId	string	当资源包含文件时，已上传的文件名称	No
overwrite	boolean	是否重新启用已删除的资源	No
needRefresh	boolean	更新后是否刷新页面列表	No

IsRepeatResponse

是否重复的响应

名称	类型	说明	是否必填
isRepeat	boolean	是否重复	Yes

AssetIsRepeatRequest

资源是否重复的请求体

名称	类型	说明	是否必填
schema	string	资源类型 Enum: "vehicleModel" , "trafficflow" , "sensor" , "judgement" , "dynamics" , "controller"	Yes
name	string	资源名称	Yes

GeneralResponse

返回id的响应

名称	类型	说明	是否必填
id	string	被操作对象的id	Yes

4.2 案例接口相关类型

Environment

环境

名称	类型	说明	是否必填
timeOfDay	double	当前时间	Yes
lightIntensity	double	光照强度	Yes
ambientLightIntensity	double	环境光	Yes
artificialLightIntensity	double	人造光	Yes
heightAngle	double	高度角	Yes
cloudDensity	double	云密度	Yes
rainDensity	double	雨密度	Yes
fogDensity	double	雾密度	Yes
snowDensity	double	雪密度	Yes
ground	{ “enable” : boolean, “humidityLevel” : double, “dirtyLevel” : double, “adhesionCoefficient” : double }	地面参数	Yes
id	string	环境id	Yes
name	string	环境名称	Yes
schema	string	资源类型 Enum: "environment"	Yes
thumbnail	string	缩略图路径	No
builtIn	boolean	是否为内置	No
classId	string	类型	Yes
time	string	时间	Yes

EnvironmentList

案例环境列表

名称	类型	说明	是否必填
byId	{ [id]: Environment }	环境实例id和环境数据作为键值对的对象	Yes
allIds	[ string ]	环境实例id列表	Yes

CaseSensorList

案例路测传感器列表

名称	类型	说明	是否必填
byId	{ [id]: Sensor }	传感器实例id和传感器数据作为键值对的对象	Yes
allIds	[ string ]	传感器实例id列表	Yes

JudgementList

案例判定列表

名称	类型	说明	是否必填
byId	object	判定实例id和数据作为键值对的对象	Yes
allIds	[ string ]	判定实例id	Yes

SpecialAreaList

案例特殊区域列表

名称	类型	说明	是否必填
byId	object	特殊区域实例id和数据作为键值对的对象	Yes
allIds	[ string ]	特殊区域实例id	Yes

MapGenConfigItem

案例地图配置

名称	类型	说明	是否必填
enable	boolean	是否自动生成道路周边场景	Yes
distance	double	间距	No
distanceToRoadVerge	double	距路边的距离	No

MapGenConfig

案例地图配置列表（键值对）

Record<string, MapGenConfigItem >

CommunicationConfig

通信公共参数设置

名称	类型	说明	是否必填
frequencyBand	double	频段	Yes
bandwidth	double	带宽	Yes
maxRadiu	double	最大覆盖范围半径	Yes
protocol	string	协议 Enum: "LTE-V"	Yes
model	string	无线通信传输模型 Enum: "Urban" , "Rural"	Yes
psSwitch	boolean	是否启用无线通信性能仿真	Yes

CaseData

案例数据

名称	类型	说明	是否必填
environments	EnvironmentList	环境配置	Yes
sensors	CaseSensorList	路侧传感器配置	Yes
judgements	JudgementList	判定配置	Yes
specialAreas	SpecialAreaList	特殊区域配置	Yes
mapGenConfig	MapGenConfig	地图配置	No
communicationParams	CommunicationConfig	通信公共参数设置	No
schema	string	类型 Enum: "casedata"	Yes
caseId	string	案例id	Yes

CaseCreateOptions

创建案例选项

名称	类型	说明	是否必填
envId	string	指定环境id	No
mapGenConfig	MapGenConfig	地图配置	No
autoMapScene	boolean	省略	No
scenario	{ “vehicleId” : string, “content” : string }	省略	No
taskId	string	已完成任务存为案例时使用，任务id	No
changeType	boolean	已完成任务存为案例时使用，表示是否把主车转换为对手车	No

CaseCreateRequest

创建案例请求体

名称	类型	说明	是否必填
casedata	CaseData	案例数据	No
options	CaseCreateOptions	创建案例选项	No
needRefresh	boolean	创建完成后是否更新页面	No

CaseSaveResponse

更新案例的响应

名称	类型	说明	是否必填
code	double	成功时为0	No
msg	string	返回信息	No

CaseDefVehicle

案例主车配置

名称	类型	说明	是否必填
id	string	案例主车资源id	Yes
name	string	主车名称	Yes
classId	string	主车模型id	Yes
physicalGradeSensor	double	物理传感器数量	Yes
category	string	省略	No
instanceId	string	案例配置主车实例id	No
instanceName	string	案例中的实例名称	No
instanceColor	string	实例配色	No

CaseDef

案例

名称	类型	说明	是否必填
schema	string	类型 Enum: "casedef"	Yes
id	string	案例id	Yes
name	string	案例名称	Yes
userId	string	用户名称	Yes
created	double	创建时间	Yes
lastModified	double	修改时间	Yes
opponent	object	案例类型	Yes
categoryId	string	目录id	No
mapId	string	地图id	Yes
mapName	string	地图名称	No
vehicles	[ CaseDefVehicle ]	主车信息列表	No
vehicleId	[ string ]	主车id列表	No
tags	[ string ]	标签列表	No
notes	string	备注	No
builtIn	boolean	是否内置的	No
joinway	string	省略	No
thumbnail	string	缩略图	No
roadSidePhysicalGradeSensor	double	路侧物理传感器数量	No

PartialCaseDef

Partial< CaseDef >

表示 CaseDef 的每个键值对都是可选的

CaseSaveRequest

更新案例请求体

名称	类型	说明	是否必填
casedef	PartialCaseDef	案例信息	No
casedata	CaseData	案例配置数据	Yes
needRefresh	boolean	更新后是否更新页面	No

CaseCloneResponse

案例克隆响应

名称	类型	说明	是否必填
clonedIds	[ string ]	复制成功后案例 id	Yes

CaseCloneRequest

案例克隆请求

名称	类型	说明	是否必填
ids	[ string ]	需要复制的案例的 id	Yes
categoryId	string	复制进文件夹的 id	Yes

CaseMoveResponse

移动案例响应

名称	类型	说明	是否必填
movedIds	[ string ]	案例id列表	Yes

CaseMoveRequest

移动案例请求

名称	类型	说明	是否必填
ids	[ string ]	需要移动的案例的 id	Yes
categoryId	string	目的文件夹的 id	Yes

IRow

案例目录

名称	类型	说明	是否必填
id	string	目录id	Yes
parentId	string	父目录id	No

CaseExportRequest

导出案例请求

名称	类型	说明	是否必填
caseIds	[ string ]	案例id列表	Yes
includesVehicle	boolean	是否包含主车	Yes
includesMap	boolean	是否包含地图	Yes
format	string	导出的案例格式 Enum: "simone" , "xosc"	Yes
pathinfo	[ IRow ]	导出案例的目录信息	Yes

CaseImportResponse

导入案例响应

名称	类型	说明	是否必填
id	string	导入文件的md5码	Yes
isFixed	boolean	是否修复格式错误的案例	No
reasons	[ [ string ] ]	错误原因	No

Recordstringstring

键值对（值的类型是字符串）

Reacord<string, string>

CaseOverrideInfo

导入案例时的主车和地图信息

名称	类型	说明	是否必填
id	string	上传文件内包含的案例（包含相对路径）	Yes
name	string	名称	Yes
replaceMap	boolean	是否替换地图	Yes
replaceVehicle	boolean	是否替换主车	Yes
missingMap	boolean	是否缺失地图	Yes
missingVehicle	boolean	是否缺失主车	Yes
overrideMapId	string	要替换为的地图id	Yes
overrideVehicleId	string	要替换为的主车id	Yes
mapId	string	可忽略	No
mapName	string	可忽略	No
vehicleIds	[ string ]	可忽略	No
path	string	可忽略 上传文件内包含的案例（包含相对路径）+ ext	No

CaseImportRequest

导入案例的请求

名称	类型	说明	是否必填
id	string	上传 file 文件时的 uploadId（uuid）	Yes
file	string	file 的 md5 （在服务端用作临时文件名称）	Yes
category	string	目录文件夹	Yes
includesVehicle	boolean	是否包含主车	Yes
includesMap	boolean	是否包含地图	Yes
includes	[ string ]	上传文件内包含哪些案例（包含相对路径）	Yes
needRemoveCases	Recordstringstring	传空对象就可以{}	Yes
overrides	[ CaseOverrideInfo ]	传空数组就可以[]	Yes
categoryInfo	Recordstringstring	传空对象就可以{}	Yes
includesStopTrigger	boolean	添加默认案例结束条件（仿真时间>60s）	No
excludeVehicleIds	[ string ]	传空数组就可以[]	No
excludeMapIds	[ string ]	传空数组就可以[]	No
replaceVehiclesMap	Recordstringstring	被替换的主车	No
replaceMapIds	[ string ]	被替换的地图（从资源库删除）	No
name	string	上传文件的名称	Yes
ext	string	file 后缀 （zip、sim、xosc）	Yes
ignoreNameChecking	boolean	标签列表	No
tags	[ string ]	标签列表	No
notes	string	备注	No
needFix	boolean	是否需要验证失败的案例	No
needFixCases	[ string ]	验证失败并需要修复的案例	No

CheckSensorsRequest

检测案例配置的传感器是否过载的请求

名称	类型	说明	是否必填
caseIds	[ string ]	需要运行的案例 id	Yes
maxWay	double	系统支持的传感器数量	Yes
vehicleId	string	运行案例使用的主车 id, 不指定主车传”-1”	Yes

4.3 地图接口相关类型

CreateMapParams

创建地图参数

名称	类型	说明	是否必填
category	string	地图类型（目录） Enum: "integrated" , "atomic" , "customized" , "city" , "city_viaduct" , "city_parking" , "city_integrated" , "i_highway" , "i_highway_integrated" , "straightway" , "turn" , "crossroads" , "T_junction" , "roundabout" , "a_highway"	Yes
id	string	默认是“”	Yes
name	string	名称	Yes
size	double	从xodr解析获取	Yes
ppm	double	从xodr解析获取	Yes
bgColor	string	从xodr解析获取	Yes
reproject	boolean	从xodr解析获取	Yes
reprojectOrigin	boolean	从xodr解析获取	Yes
reprojectOriginLat	double	从xodr解析获取	Yes
reprojectOriginLng	double	从xodr解析获取	Yes
tags	[ string ]	标签列表	No
notes	string	备注	No

MapCreateRequest

创建地图请求

名称	类型	说明	是否必填
params	CreateMapParams	JSON 需要字符化	Yes
xodr	File	xodr 文件	Yes
thumbnail	File	地图缩略图文件	No

4.4 文件接口相关类型

UploadFileParams

上传文件参数

名称	类型	说明	是否必填
uploadId	string	uuid	Yes
category	string	业务类型	Yes
filename	string	文件名称	Yes
index	double	chunks序号	Yes
chunks	double	分几次上传	Yes
filesize	double	当前chunk大小	Yes

FileUploadRequest

上传文件请求

名称	类型	说明	是否必填
params	UploadFileParams	JSON 需要字符化	Yes
file	File	文件	Yes

4.5 主车接口相关类型

VehicleList

主车列表

名称	类型	说明	是否必填
byId	{[id]: VehicleItem }	主车id和数据作为键值对的对象	Yes
allIds	[ string ]	主车资源id	Yes

BasePageResponseVehicleList

获取主车列表的响应

名称	类型	说明	是否必填
list	VehicleList	主车列表	Yes
page	double	当前页码	Yes
total	double	主车总数	Yes

VehicleCreateRequest

创建主车的请求

名称	类型	说明	是否必填
name	string	主车名称	Yes
classId	string	主车模型 id	Yes
overwriteId	string	要覆盖的主车 id	No

DataBlock

键值对

Reacord<string, any>

VehicleDynamics

主车动力学

名称	类型	说明	是否必填
id	string	ID	Yes
name	string	名称	Yes
schema	string	资源类型 "dynamics"	Yes
builtIn	boolean	是否内置	No
type	string	动力学类型 Enum: "srvehicles" , "srvehicle-truck" , "srvehicle-bus" , "carsim" , "carmaker" , "vigrade" , "none"	Yes
params	DataBlock	动力学参数	Yes

VehicleCtl

主车控制器

名称	类型	说明	是否必填
id	string	ID	Yes
type	string	类型	Yes
name	string	名称	Yes
params	DataBlock	控制器参数	Yes
aideId	string	辅助控制器id	No
builtIn	boolean	是否内置	No

SensorOutput

传感器输出设置

名称	类型	说明	是否必填
byType	{[selected]: any}	输出配置	Yes
selected	string	输出格式	Yes

Sensor

传感器

名称	类型	说明	是否必填
id	string	ID	Yes
name	string	名称	Yes
schema	string	资源类型 Enum: "sensor"	Yes
category	string	目录id	Yes
thumbnail	string	缩略图路径	No
builtIn	boolean	是否内置	No
classId	string	类型	Yes
x	double	x方向位置	Yes
y	double	y方向位置	Yes
z	double	z方向位置	Yes
roll	double	倾斜角	Yes
pitch	double	倾斜角	Yes
yaw	double	倾斜角	Yes
params	DataBlock	传感器参数	Yes
includeIds	[ string ]	融合传感器时，融合了哪些传感器	No
output	SensorOutput	传感器输出设置	No
disabled	boolean	是否禁用	No
presetId	string	非内置时，表示原始传感器id	No

VehicleItem

主车

名称	类型	说明	是否必填
id	string	ID	Yes
name	string	名称	Yes
thumbnail	string	缩略图路径	No
builtIn	boolean	是否是内置	No
schema	string	类型 Enum: "vehicle"	Yes
classId	string	模型id	Yes
driver	string	忽略 Enum: "ai" , "human"	Yes
dynamics	VehicleDynamics	动力学参数	Yes
controller	VehicleCtl	控制器	Yes
category	string	主车类型 Enum: "Bike" , "Vehicle" , "Pedestrian"	Yes
sensors	[ Sensor ]	传感器配置	Yes

PartialVehicleItem

Partial< VehicleItem >

表示 VehicleItem 的每个键值对都是可选的

VehicleSaveResponse

更新主车的响应

名称	类型	说明	是否必填
data	PartialVehicleItem	更新后的数据	Yes

VehicleSaveRequest

更新主车的请求

名称	类型	说明	是否必填
data	PartialVehicleItem	主车信息	Yes
overwrite	boolean	如果当前主车已删除，是否重新启用	No
needRefresh	boolean	更新后是否刷新页面	No

IsRepeatRequest

主车或测试集名称是否重复的请求

名称	类型	说明	是否必填
name	string	名称	Yes

VehiclesCreateRequest

导入主车的请求

名称	类型	说明	是否必填
vehicleData	VehicleList	导入主车的数据	Yes

VehicleReplaceRequest

更新主车资源文件的请求

名称	类型	说明	是否必填
params	{ “type” : “controller” or “dynamics” }	替换控制器或者动力学相关的资源，传参时需要字符串化	Yes
file	File	要替换的资源文件	Yes

4.6 测试集接口相关类型

SuiteList

测试集列表

名称	类型	说明	是否必填
byId	{[id]: Suite }	suiteid和数据的键值对	Yes
allIds	[ string ]	测试集id列表	Yes

SuiteCreateRequest

创建测试集的请求

名称	类型	说明	是否必填
parentId	string	父目录id	Yes
name	string	名称	Yes

Suite

测试集

名称	类型	说明	是否必填
schema	string	类型 Enum: "suite"	Yes
id	string	ID	Yes
name	string	名称	Yes
userId	string	用户id	Yes
parentId	string	父目录id	Yes
caseIds	[ string ]	包含哪些用例	No

PartialSuite

Partial< Suite >

表示 Suite 的每个键值对都是可选的

SuiteSaveResponse

更新测试集的响应

名称	类型	说明	是否必填
data	PartialSuite	更新后的测试集	Yes

SuiteSaveRequest

更新测试集的请求

名称	类型	说明	是否必填
data	PartialSuite	要更新的测试集	Yes
caseIds	[ string ]	要操作的案例id列表	No
delete	boolean	表示删除或者添加caseIds	No

4.7 页面目录接口相关类型

CategoryMoveRequest

移动测试集的请求

名称	类型	说明	是否必填
dragId	string	要移动的测试集id	Yes
dropId	string	移动到相对这个测试集的某个位置	Yes
state	string	相对dropId的位置 Enum: "up" , "down" , "inside"	Yes

4.8 对手元素接口相关类型

ObstacleNpc

对手元素

名称	类型	说明	是否必填
id	string	ID	Yes
category	string	类型	Yes
schema	string	元素分类 Enum: "dynamic" , "static"	Yes
assetId	double	资源id	No
name	string	名称	No
uicategory	string	目录id	No
oscSubCategory	string	osc类型	No
resourceType	string	元素资源的类型 Enum: "model" , "chartlet" , "external"	No
resourceMd5	string	资源文件md5	No
thumbnail	string	缩略图路径	Yes
interpo	string	忽略 Enum: "clothoid" , "legacy"	Yes
semantic	string	语义类型 Enum: "vehicle" , "none"	Yes
builtIn	boolean	是否内置	No
modelPath	string	外挂模型路径	No
aniPath	string	外挂动画路径	No
dimensions	{ “length” : double, “width” : double, “height” : double }	尺寸	No
originToCenter	{ “x” : double, “y” : double, “z” : double }	原点位置	No

PartialObstacleNpc

Partial< ObstacleNpc >

表示 ObstacleNpc 的每个键值对都是可选的

BasePageResponseObstacleNpcArray

获取对手元素列表的响应

名称	类型	说明	是否必填
list	[ ObstacleNpc ]	对手元素列表	Yes
page	double	当前页码	Yes
total	double	总数	Yes

ObstacleCreateRequest

创建对手元素的请求

名称	类型	说明	是否必填
data	PartialObstacleNpc	元素参数	Yes
sourceId	string	已上传的文件 md5	Yes
thumbnailId	string	已上传的缩略图的 md5	No