- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- API参考
- SDK参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功！
创建场景地图
功能介绍
此接口用于创建OpenDRIVE格式的场景地图。接口基于地图文件的sha256判断地图文件是否已存在，如果地图文件不存在，响应中提供预签链接用于上传地图文件。
URI
POST https://{hostURL}/v2/{project_id}/sim/sm/maps
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
file |
是 |
FileCreateSrlz object |
地图文件信息。 |
|
version |
是 |
String |
|
|
agreement_confirm |
是 |
Boolean |
是否同意免责声明，必须为true。 |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
地图资源地址。 |
|
id |
Integer |
地图ID。 |
|
created_at |
Double |
创建时间。 |
|
updated_at |
Double |
更新时间。 |
|
file |
FileCreateSrlz object |
地图文件信息。 |
|
version |
String |
|
|
agreement_confirm |
Boolean |
是否同意免责声明，必须为true。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
文件资源地址。 |
|
sha256 |
String |
文件sha256值。 |
|
created_at |
Double |
创建时间。 |
|
updated_at |
Double |
更新时间。 |
|
post |
post object |
POST预签链接信息，用于上传文件。 |
|
put_url |
String |
PUT预签链接地址，用于上传文件。优先使用POST方法上传。 |
|
get_url |
String |
GET地址，用于下载文件。 |
|
expire |
Integer |
默认失效时间为600秒。 |
|
ready |
Boolean |
文件状态。完成文件上传状态为true，未完成文件上传状态为false。 |
|
filename |
String |
文件名。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
POST预签链接信息，用于上传文件。 |
|
fields |
PostResponseField object |
POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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/maps/
{
"version" : "v1.6.0",
"file" : {
"sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60",
"filename" : "ALKS_Road_straight.xodr"
}
}响应示例
状态码：201
请求成功
{
"url" : "/v2/my_project_id/sim/sm/maps/2631662/",
"id" : 2631662,
"created_at" : 1.699954027366838E9,
"updated_at" : 1.699954027366882E9,
"file" : {
"url" : "/v2/my_project_id/sim/sm/files/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60/",
"sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60",
"created_at" : 1.699954027363056E9,
"updated_at" : 1.699954027363114E9,
"post" : {
"url" : "https://post_url",
"fields" : {
"key" : "sim/ifiles/map/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60.xodr",
"x-amz-algorithm" : "AWS4-HMAC-SHA256",
"x-amz-credential" : "my-x-amz-credential",
"x-amz-date" : "20231114T092707Z",
"policy" : "my-policy",
"x-amz-signature" : "my-x-amz-signature"
},
"put_url" : "my-put-url",
"get_url" : null,
"expire" : 600,
"ready" : false,
"filename" : "ALKS_Road_straight.xodr"
},
"version" : "v1.6.0"
},
"agreement_confirm" : true
}状态码
|
状态码 |
描述 |
|---|---|
|
201 |
请求成功 |
错误码
请参见错误码。
