更新时间:2025-06-24 GMT+08:00
分享

创建场景地图

功能介绍

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

URI

POST https://{hostURL}/v2/{project_id}/sim/sm/maps

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

file

FileCreateSrlz object

地图文件信息。

version

String

  • v1.4.0 - v1.4.0

  • v1.5.0 - v1.5.0

  • v1.6.0 - v1.6.0

  • v1.6.1 - v1.6.1

  • v1.7.0 - v1.7.0

agreement_confirm

Boolean

是否同意免责声明,必须为true。

表3 FileCreateSrlz

参数

是否必选

参数类型

描述

sha256

String

文件sha256值。

filename

String

文件名。

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

url

String

地图资源地址。

id

Integer

地图ID。

created_at

Double

创建时间。

updated_at

Double

更新时间。

file

FileCreateSrlz object

地图文件信息。

version

String

  • v1.4.0 - v1.4.0

  • v1.5.0 - v1.5.0

  • v1.6.0 - v1.6.0

  • v1.6.1 - v1.6.1

  • v1.7.0 - v1.7.0

agreement_confirm

Boolean

是否同意免责声明,必须为true。

表5 FileCreateSrlz

参数

参数类型

描述

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

文件名。

表6 post

参数

参数类型

描述

url

String

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

fields

PostResponseField object

POST预签链接信息,调用POST预签链接上传文件时用于构造请求。

表7 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

请求成功

错误码

请参见错误码

相关文档