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

创建场景地图

功能介绍

此接口用于创建OpenDRIVE格式的场景地图。接口基于地图文件的sha256判断地图文件是否已存在，如果地图文件不存在，响应中提供预签链接用于上传地图文件。

URI

POST /v2/{project_id}/sim/sm/maps

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

url

是

String

地图资源地址。

id

是

Integer

地图ID。

created_at

是

Double

创建时间。

最小值：0

updated_at

是

Double

更新时间。

最小值：0

file

是

FileCreateSrlz object

地图文件信息。

version

是

String

地图文件的OpenDRIVE版本。

枚举值：

  • v1.4.0

  • v1.5.0

  • v1.6.0

  • v1.6.1

  • v1.7.0

agreement_confirm

是

Boolean

是否同意免责声明，必须为true。
表3 FileCreateSrlz

参数

是否必选

参数类型

描述

url

是

String

文件资源地址。

sha256

是

String

文件sha256值。

最小长度：64

最大长度：64

created_at

是

Double

创建时间。

最小值：0

updated_at

是

Double

更新时间。

最小值：0

post

是

post object

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

put_url

是

String

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

get_url

是

String

GET地址，用于下载文件。

expire

是

Integer

默认失效时间为600秒。

缺省值：600

ready

是

Boolean

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

filename

是

String

文件名。

最大长度：255
表4 post

参数

是否必选

参数类型

描述

url

否

String

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

fields

否

PostResponseField object

POST预签链接信息，调用POST预签链接上传文件时用于构造请求。
表5 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字段，在创建请求时需要添加到请求头。

响应参数

状态码： 201

表6 响应Body参数

参数

参数类型

描述

url

String

地图资源地址。

id

Integer

地图ID。

created_at

Double

创建时间。

最小值：0

updated_at

Double

更新时间。

最小值：0

file

FileCreateSrlz object

地图文件信息。

version

String

地图文件的OpenDRIVE版本。

枚举值：

  • v1.4.0

  • v1.5.0

  • v1.6.0

  • v1.6.1

  • v1.7.0

agreement_confirm

Boolean

是否同意免责声明，必须为true。
表7 FileCreateSrlz

参数

参数类型

描述

url

String

文件资源地址。

sha256

String

文件sha256值。

最小长度：64

最大长度：64

created_at

Double

创建时间。

最小值：0

updated_at

Double

更新时间。

最小值：0

post

post object

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

put_url

String

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

get_url

String

GET地址，用于下载文件。

expire

Integer

默认失效时间为600秒。

缺省值：600

ready

Boolean

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

filename

String

文件名。

最大长度：255
表8 post

参数

参数类型

描述

url

String

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

fields

PostResponseField object

POST预签链接信息，调用POST预签链接上传文件时用于构造请求。
表9 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/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

请求成功

错误码

请参见错误码。

父主题： 场景地图

相关文档