文档首页> 云地图服务 KooMap> API参考> API> 实景三维数据管理> 查询实景三维成果数据列表
更新时间:2024-05-17 GMT+08:00
分享

查询实景三维成果数据列表

功能介绍

查询实景三维成果数据列表。返回成果数据查询结果以更新时间倒序排列,支持根据以下条件查询:

  • product_name:成果数据名称,模糊匹配。

  • product_id:成果数据ID,精确匹配。

  • offset:查询记录偏移量,设置忽略前面多少个记录,缺省值为0。

  • limit:查询返回的记录条数,缺省值为10。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/real3d/products

表1 Query参数

参数

是否必选

参数类型

描述

offset

Integer

偏移量。查询时忽略的记录数量。

最小值:0

最大值:2147483647

缺省值:0

limit

Integer

分页大小。

最小值:1

最大值:100

缺省值:10

product_name

String

成果数据名称。支持模糊搜索。

product_id

String

成果数据ID。

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

products

Array of Real3DProductVO objects

实景三维成果数据列表。

page

Page object

分页信息。

表3 Real3DProductVO

参数

参数类型

描述

id

String

成果数据ID。

name

String

成果数据名称。

status

String

成果数据状态。

  • preparing:准备中。处于该状态表示成果模型数据正在准备,需要在该状态后才能下载、删除。

  • available:可用。处于该状态时成果模型可以下载、删除。

  • deleting:删除中。成果模型正在删除。

folder_code

String

倾斜影像编码。

task_info

Real3DProductRelateTaskVO object

相关任务信息。

product_details

Array of Real3DProductDetailVO objects

成果数据详情。

storage_size_byte

Double

成果数据占用存储空间大小(字节)。

create_time

String

创建时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time

String

更新时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

tenant_domain_id

String

华为云IAM租户账号ID。

表4 Real3DProductRelateTaskVO

参数

参数类型

描述

task_id

String

任务ID。

task_name

String

任务名称。

task_params

String

任务建模参数。

task_exec_start_time

String

任务执行开始时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

task_exec_end_time

String

任务执行结束时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

表5 Real3DProductDetailVO

参数

参数类型

描述

type

String

文件类型。

  • mesh_osgb:纹理模型格实景三维模型输出.osgb三维预览文件。

  • mesh_obj:纹理模型格实景三维模型输出.obj三维模型文件。

  • nerf_osgb:显式辐射场实景三维模型输出.osgb三维预览文件。

  • nerf_obj:显式辐射场实景三维模型输出.obj三维模型文件。

  • metadata: metadata.xml文件,用于模型坐标校准。

storage_size_byte

Double

文件占用存储空间大小(字节)。

files

Array of strings

文件名称列表。

表6 Page

参数

参数类型

描述

offset

Integer

偏移量,表示从第几条数据开始查询。

limit

Integer

每页包含的查询记录数量。

total

Integer

符合查询条件的记录总数。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为:KMP.XXXXXXXX,其中X表示数字。

最小长度:12

最大长度:12

error_msg

String

错误描述。

最小长度:2

最大长度:512

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为:KMP.XXXXXXXX,其中X表示数字。

最小长度:12

最大长度:12

error_msg

String

错误描述。

最小长度:2

最大长度:512

请求示例

从第0个开始查询10个成果数据列表。

GET https://{Endpoint}/v1/real3d/products?offset=0&limit=10

响应示例

状态码: 200

请求成功。

{
  "products" : [ {
    "id" : "b6fbb5c6b7ba4b89aaeadfaba3df7xxx",
    "name" : "AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445",
    "status" : "preparing",
    "folder_code" : "fa693df75e0e47c88c8eefb2c639axxx",
    "folder_info" : "{\"folder_name\":\"AUTO_api_1981c24729f611ee947ef86365693xxx\",\"folder_alias\":\"19ae9fbb29f611ee98dff863656935b3\",\"create_time\":\"2023-07-24T07:46:18Z\",\"folder_desc\":\"api\"}",
    "task_info" : "{\"task_exec_end_time\":\"2023-07-28T02:34:21Z\",\"task_exec_start_time\":\"2023-07-28T01:53:00Z\",\"task_id\":\"db9743d353c741478fd4cfc725081a6f\",\"task_name\":\"546454\",\"task_params\":\"{\\\"accuracy\\\":\\\"High\\\",\\\"mesh_accuracy\\\":\\\"1\\\",\\\"key_point_limit\\\":\\\"40000\\\",\\\"tie_point_limit\\\":\\\"4000\\\"}\",\"task_status\":\"SUCCESS\",\"task_type\":\"REAL3D-UNCTRL\"}",
    "product_details" : [ {
      "type" : "mesh_osgb",
      "storage_size_byte" : 0,
      "files" : [ "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+000~+000.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+001~+001.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+002~+002.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+003~+003.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+004~+004.zip" ]
    }, {
      "type" : "mesh_obj",
      "storage_size_byte" : 0,
      "files" : [ ]
    } ],
    "storage_size_byte" : null,
    "create_time" : "2023-07-28T02:34:45Z",
    "update_time" : "2023-07-28T02:34:45Z",
    "tenant_domain_id" : "234602bf93714dcba145eaa45686exxx"
  } ],
  "page" : {
    "offset" : 0,
    "limit" : 1,
    "total" : 47
  }
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品