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	说明	类型
202	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}

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	说明	类型
202	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

4.9 算法接口(3.7.0)¶

4.9.1 获取算法列表¶

Path： /api-asset/algorithms

Method： GET

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型	备注
type	query	Enum: `"client"`, `"cloud"`, `""`	Yes	string
clientId	query	客户端机器 UUID	No	string	3.7.0
isWindows	query	算法运行系统是否是 windows	No	boolean
projectId	query	项目 Id	No	string
keyword	query	搜索关键字	No	string
page	query	页码	Yes	string
pageSize	query	每页数量	No	string

返回数据¶

Code	说明	类型
200	Ok	AlgorithmListResponse

4.9.2 获取算法版本¶

Path： /api-asset/algorithms/${algorithmId}/versions/${versionId}

Method： GET

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
algorithmId	path	算法 id	Yes	string
versionId	path	算法版本 id	No	string

返回数据¶

Code	说明	类型
200	Ok	AlgorithmVersion

4.9.3 获取算法版本列表¶

Path： /api-asset/algorithms/${algorithmId}/versions

Method： GET

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
algorithmId	path	算法 id	Yes	string

返回数据¶

Code	说明	类型
200	Ok	[AlgorithmVersion]

4.9.4 新增算法¶

Path： /api-asset/algorithms

Method： POST

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
data	body	算法及版本数据	Yes	AlgorithmCreateData
sourceId	body	上传的算法资源	No	string

返回数据¶

Code	说明	类型
200	Ok	{ “name”: string; “id”: string }

4.9.5 更新算法¶

Path： /api-asset/algorithms/${id}

Method： PUT

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
name	body	重名名时传入	No	string
activatedId	body	删除当前 activatedId 的算法版本时，需要重置一个 activatedId	No	string

返回数据¶

Code	说明	类型
200	Ok	{ “name”: string; “id”: string }

4.9.6 删除算法¶

Path： /api-asset/algorithms/delete

Method： POST

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
ids	body	需要删除的算法 id	No	string[]

返回数据¶

Code	说明	类型
200	Ok

4.9.7 算法名称是否已经存在¶

Path： /api-asset/algorithms/exists/{name}

Method： GET

Headers：Headers

请求参数¶

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

返回数据¶

Code	说明	类型
200	Ok	{ “exists”: string; “id”: string }

4.9.8 添加算法版本¶

Path： /api-asset/algorithms/${id}/versions

Method： POST

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
id	path	算法 id	Yes	string
data	body	算法版本数据	Yes	Partial<AlgorithmVersion>
sourceId	body	上传的算法资源	No	string

返回数据¶

Code	说明	类型
200	Ok	{ “name”: string; “id”: string }

4.9.9 删除版本¶

Path： /api-asset/algorithms/versions/delete

Method： POST

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
ids	body	算法版本 id 列表	Yes	string[]

返回数据¶

Code	说明	类型
200	Ok

4.9.10 算法版本是否存在¶

Path： /api-asset/algorithms/${algorithmId}/exists/${version}

Method： GET

Headers：Headers

请求参数¶

参数名称	传参格式	说明	是否必填	类型
algorithmId	path	算法 id	Yes	string
version	path	算法版本	Yes	string

返回数据¶

Code	说明	类型
200	Ok	{ “exists”: string; “id”: string }

通用请求头¶

Headers¶

名称	类型	说明	是否必填	备注
Authorization	string	用于权限验证的 token	Yes
projectId	string	默认值： `"default"`	Yes	3.7.0
accept	application/json	客户端接收 JSON 数据	No

FormDataHeaders¶

名称	类型	说明	是否必填
Authorization	string	用于权限验证的 token	Yes
projectId	string	默认值： `"default"`	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	地图缩略图文件	Yes

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

4.9 算法接口相关类型¶

AlgorithmListResponse¶

获取算法列表的响应

名称	类型	说明	是否必填
list	[ Algorithm ]	算法列表	Yes
page	double	当前页码	Yes
total	double	总数	Yes

Algorithm¶

算法

名称	类型	说明	是否必填	备注
id	string	算法 id	Yes
name	string	名称	Yes
type	string	类型 Enum: `"client"`, `"cloud"`, `"builtIn"`	Yes
activatedId	string	最新算法版本 Id	Yes
activated	AlgorithmVersion	最新算法版本	No
clientId	string	所属客户端 UUID	No	3.7.0

AlgorithmVersion¶

算法版本

名称	类型	说明	是否必填
id	string	算法版本 id	Yes
algorithmId	string	所属算法 id	Yes
type	string	接入方式 Enum: `"Manual"`, `"SM"`, `"SimOneDriver"`, `"Simulator`, `"Simulink"` 等	Yes
params	object	算法参数	Yes
notes	string	备注	No

AlgorithmCreateData¶

算法创建参数

名称	类型	说明	是否必填
name	string	名称	Yes
type	string	类型 Enum: `"client"`, `"cloud"`, `""`	Yes
versionData	object	Partial<AlgorithmVersion>	Yes
projectId	string	项目 id	No
notes	string	备注	No
id	string	算法 id	No