华为云用户手册

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前KooMap所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，当前KooMap只在“华北-北京四”部署，Endpoint为“koomap.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“创建工作共享空间”API的resource-path为“/v1/workspaces”。 query-string 可选参数，用于查询指定参数数据。设置查询参数时，查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取KooMap在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（koomap.cn-north-4.myhuaweicloud.com），并在创建工作共享空间的URI部分找到resource-path（/v1/workspaces），拼接起来如下所示。 https://koomap.cn-north-4.myhuaweicloud.com/v1/workspaces 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "task_id" : "914305233ef7428e8073a95d8042fxxx", "task_name" : "测试任务1685087027834", "task_type" : "REAL3D-UNCTRL", "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx", "modeling_params" : { "accuracy" : "High", "key_point_limit" : 40000, "tie_point_limit" : 4000, "center_x_offset" : 0, "center_y_offset" : 0, "center_z_offset" : 0, "mesh_accuracy" : 0, "is_calibration" : true, "blend_intensity" : 0, "compress_accuracy" : 0, "intp_accuracy" : 0 }, "coordinate_sys" : "WGS84-UTM", "has_marker" : false, "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgpxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T08:00:00Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "task_status" : "ARCHIVED", "complete_stage" : 10, "total_stage" : 10, "exec_start_time" : "2023-05-26T07:57:00Z", "task_progress" : "1.00", "exec_stop_time" : "2023-05-26T08:00:00Z", "fail_message" : null, "AT_progress" : null }

请求示例 该请求对运行成功的任务进行归档。 POST https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx/archive { "archive" : true } 该请求对已归档的任务进行取消归档。 https://{endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx/archive { "archive" : false }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 task_id String 任务ID。 task_name String 任务名称。 task_type String 任务类型。 REAL3D-UNCTRL（无控建模） REAL3D-CTRL（有控建模） modeling_type String 建模类型。 Mesh：纹理模型实景三维建模。 Nerf：显式辐射场实景三维建模。 task_description String 任务描述。 workspace_id String 任务所属工作共享空间ID。 modeling_params ModelingParams object 任务建模参数列表。 coordinate_sys String 建模坐标系。 has_marker Boolean 是否添加了刺点。 folder_code String 任务绑定的倾斜影像的影像code。 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。 creator String 任务创建人。 latest_operator String 任务最近操作人。 task_status String 任务当前状态。 INIT（初始化） PENDING（等待中） STARTING（启动中） START_FAILED（启动失败） RUNNING（运行中） SUCCESS（运行成功） FAILED（运行失败） STOPPING（停止中） STOP_SUCCESS（已停止） ARCHIVED（已归档） BUNDLE_SUCCESS（空三建模成功） complete_stage Integer 建模已完成作业步骤数。 total_stage Integer 建模总作业步骤数。 task_progress String 任务进度。该字段为字符串表示的保留两位小数的浮点型数值，取值范围：0.00~1.00。 exec_start_time String 任务执行开始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 exec_stop_time String 任务执行结束时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 fail_message String 失败消息。当任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。 AT_progress String 空三建模进度，取值范围：0.00~1.00。展示有控建模任务空三建模阶段的执行进度。因为空三建模仅在有控建模任务中执行，无控建模任务中该字段取值始终为null。 表5 ModelingParams 参数 参数类型 描述 accuracy String 空三精度。取值包括：Highest、High、Medium、Low、Lowest。 缺省值：High key_point_limit Integer 空三关键点数量。取值范围：1000~1000000。 缺省值：40000 tie_point_limit Integer 空三连接点数量。取值范围：100~100000。 缺省值：4000 mesh_accuracy Integer Mesh重建质量。枚举值： 0：高 1：中 2：低 缺省值：0 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 workspace_name 是 String 工作共享空间名称。支持中文、英文、数字以及“_”字符，长度限制2~50个字符。 workspace_description 否 String 工作共享空间描述。支持中文、英文、数字以及“_”字符，长度限制200个字符以内。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 workspace_id String 工作共享空间ID。 workspace_name String 工作共享空间名称。 workspace_description String 工作共享空间描述。 tenant_domain_id String 华为云IAM租户账号ID。 creator String 创建人。 latest_operator String 最近修改人。 create_time String 创建时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time String 更新时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 star Integer 工作共享空间是否置顶显示（最多可置顶4个）。 can_delete Boolean 工作共享空间是否允许删除标志位。当工作共享空间置顶显示或者该空间下存在任务时，取值为“true”，表示不可以删除。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "workspace_id" : "3eceb0cb8b834f5bb0a66d4108c2067f", "workspace_name" : "测试空间", "workspace_description" : "空间描述", "creator" : "xxxx", "latest_operator" : "xxxx", "create_time" : "2023-05-23T07:26:28Z", "update_time" : "2023-05-23T07:26:28Z", "star" : 0, "can_delete" : false }

功能介绍 该接口用于启动精修后处理任务。该接口运行成功后，任务状态更新为等待中（PENDING），此时任务添加到启动队列中等待运行资源就绪，资源就绪后状态更新为启动中（STARTING），启动成功后状态更新为运行中（RUNNING），若启动失败则状态更新为启动失败（START_FAILED）。 精修后处理任务允许启动的状态为：上传成功（UPLOAD_SUCCESS）、已停止（STOP_SUCCESS）、运行失败（FAILED）。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 subtask_id String 实景三维精修后处理任务ID。 task_id String 原始实景三维建模任务ID。 subtask_name String 精修后处理任务别名。 task_name String 原始实景三维建模任务名称。 workspace_id String 原始实景三维建模任务所属工作共享空间ID。 modeling_params ModelingParams object 原始实景三维建模任务建模参数列表。 subtask_status String 实景三维精修后处理任务当前状态。 INIT（初始化） UPLOADING（上传中） UPLOAD_SUCCESS（上传成功） UPLOAD_FAILED（上传失败） PENDING（等待中） STARTING（启动中） START_FAILED（启动失败） RUNNING（运行中） SUCCESS（运行成功） FAILED（运行失败） STOPPING（停止中） STOP_SUCCESS（已停止） model_path String 模型数据上传路径。 refine_product_id String 精修后处理任务成果数据ID。 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。 creator String 精修后处理任务创建人。 latest_operator String 精修后处理任务最近操作人。 subtask_progress String 精修后处理任务进度。该字段为保留两位小数的浮点型数值字符串，数值表示范围为0.00~1.00。 exec_start_time String 精修后处理任务执行开始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 exec_stop_time String 精修后处理任务执行结束时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 fail_message String 失败消息。当精修后处理任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。 表4 ModelingParams 参数 参数类型 描述 accuracy String 空三精度。取值包括：Highest、High、Medium、Low、Lowest。 缺省值：High key_point_limit Integer 空三关键点数量。取值范围：1000~1000000。 缺省值：40000 tie_point_limit Integer 空三连接点数量。取值范围：100~100000。 缺省值：4000 mesh_accuracy Integer Mesh重建质量。枚举值： 0：高 1：中 2：低 缺省值：0 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

URI POST /v1/real3d/{workspace_id}/tasks/{task_id}/subtasks/{subtask_id}/start 表1 路径参数 参数 是否必选 参数类型 描述 workspace_id 是 String 工作共享空间ID。 task_id 是 String 原始实景三维建模任务ID。 subtask_id 是 String 实景三维精修后处理任务ID。

响应示例 状态码： 200 请求成功。 { "subtask_id" : "914305233ef7428e8073a95d8042fxxx", "task_id" : "914305233ef7428e8073a95d8042fxxx", "subtask_name" : "精修后处理任务别名", "task_name" : "测试任务1685087027834", "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx", "modeling_params" : { "accuracy" : "High", "key_point_limit" : "40000", "tie_point_limit" : "4000", "mesh_accuracy" : "0" }, "subtask_status" : "INIT", "model_path" : "obs://real3d/real3d/xxx", "refine_product_id" : "914305233ef7428e8073a95d8042fxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:52:58Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "subtask_progress" : null, "exec_start_time" : null, "exec_stop_time" : null, "fail_message" : null }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 subtask_id String 实景三维精修后处理任务ID。 task_id String 原始实景三维建模任务ID。 subtask_name String 精修后处理任务别名。 task_name String 原始实景三维建模任务名称。 workspace_id String 原始实景三维建模任务所属工作共享空间ID。 modeling_params ModelingParams object 原始实景三维建模任务建模参数列表。 subtask_status String 实景三维精修后处理任务当前状态。 INIT（初始化） UPLOADING（上传中） UPLOAD_SUCCESS（上传成功） UPLOAD_FAILED（上传失败） PENDING（等待中） STARTING（启动中） START_FAILED（启动失败） RUNNING（运行中） SUCCESS（运行成功） FAILED（运行失败） STOPPING（停止中） STOP_SUCCESS（已停止） model_path String 模型数据上传路径。 refine_product_id String 精修后处理任务成果数据ID。 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。 creator String 精修后处理任务创建人。 latest_operator String 精修后处理任务最近操作人。 subtask_progress String 精修后处理任务进度。该字段为保留两位小数的浮点型数值字符串，数值表示范围为0.00~1.00。 exec_start_time String 精修后处理任务执行开始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 exec_stop_time String 精修后处理任务执行结束时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 fail_message String 失败消息。当精修后处理任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。 表5 ModelingParams 参数 参数类型 描述 accuracy String 空三精度。取值包括：Highest、High、Medium、Low、Lowest。 缺省值：High key_point_limit Integer 空三关键点数量。取值范围：1000~1000000。 缺省值：40000 tie_point_limit Integer 空三连接点数量。取值范围：100~100000。 缺省值：4000 mesh_accuracy Integer Mesh重建质量。枚举值： 0：高 1：中 2：低 缺省值：0 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "subtask_id" : "914305233ef7428e8073a95d8042fxxx", "task_id" : "aaaaa30b6c5f42cfaf49e01eb690xyyy", "subtask_name" : "精修后处理任务别名", "task_name" : "测试任务1685087027834", "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx", "modeling_params" : { "accuracy" : "High", "key_point_limit" : "40000", "tie_point_limit" : "4000", "mesh_accuracy" : "0" }, "subtask_status" : "INIT", "model_path" : "obs://real3d/real3d/xxx", "refine_product_id" : "914305233ef7428e8073a95d8042fxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:52:58Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "subtask_progress" : null, "exec_start_time" : null, "exec_stop_time" : null, "fail_message" : null }

URI GET /v1/real3d/refineproducts 表1 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 分页大小。 最小值：1 最大值：100 缺省值：10 refine_product_id 否 String 精修后处理成果数据ID。 task_name 否 String 原始实景三维建模任务名称。 subtask_name 否 String 精修后处理任务别名。 subtask_create_time_from 否 String 精修后处理任务创建起始时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_create_time_to 否 String 精修后处理任务创建截止时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_completed_time_from 否 String 精修后处理任务完成起始时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_completed_time_to 否 String 精修后处理任务完成截止时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 order_by 否 String 排序参数，支持task_name_asc（原始实景三维建模任务名称增序）、task_name_desc（原始实景三维建模任务名称降序）、subtask_name_asc（精修后处理任务别名增序）、subtask_name_desc（精修后处理任务别名降序）。

功能介绍 查询实景三维精修后处理成果的数据列表。支持的过滤参数： refine_product_id：精修后处理成果数据ID。 task_name：原始实景三维建模任务名称。 subtask_name：精修后处理任务别名。 subtask_create_time_from：精修后处理任务创建起始时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_create_time_to：精修后处理任务创建截止时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_completed_time_from：精修后处理任务完成起始时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 subtask_completed_time_to：精修后处理任务完成截止时间，为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 offset：分页参数，偏移量，缺省值为0。 limit：分页参数，每页数量，缺省值为10。 order_by：排序参数，支持task_name_asc（原始任务名称增序）、task_name_desc（原始任务名称降序）、subtask_name_asc（后处理任务别名增序）、subtask_name_desc（后处理任务别名降序）。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 refine_products Array of Real3DRefineProductVO objects 精修后处理成果数据对象列表。 page Page object 分页信息。 表4 Real3DRefineProductVO 参数 参数类型 描述 id String 精修后处理成果数据ID。 name String 精修后处理成果数据名称。 status String 精修后处理成果数据状态。 preparing：准备中。处于该状态表示成果数据正在准备，需要在该状态后才能下载、删除。 available: 可用。处于该状态时成果数据可以下载、删除。 deleting：删除中。成果数据正在删除。 subtask_info Real3DRefineProductRelateSubTaskVO object 关联精修后处理任务信息。 task_info Real3DRefineProductRelateTaskVO object 关联原始任务信息。 product_details Array of Real3DRefineProductDetailVO 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。 表5 Real3DRefineProductRelateSubTaskVO 参数 参数类型 描述 subtask_name String 精修后处理任务别名。 subtask_id String 精修后处理任务ID。 create_time String 精修后处理任务创建时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 completed_time String 精修后处理任务完成时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 表6 Real3DRefineProductRelateTaskVO 参数 参数类型 描述 task_id String 原始实景三维建模任务ID。 task_name String 原始实景三维建模任务名称。 workspace_id String 关联工作共享空间ID。 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'。 表7 Real3DRefineProductDetailVO 参数 参数类型 描述 type String 文件类型。nerf_osgb: 输出三维预览OSGB文件。 storage_size_byte Double 文件占用存储空间大小（字节）。 files Array of strings 文件列表。 表8 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

功能介绍 该接口用于停止状态为等待中（PENDING）、启动中（STARTING）或者运行中（RUNNING）的精修后处理任务。任务停止后，状态更新规则如下： 等待中（PENDING）的精修后处理任务执行停止后将更新为上传成功（UPLOAD_SUCCESS）状态。 启动中（STARTING）和正在运行（RUNNING）的精修后处理任务执行停止后将更新为停止中（STOPPING）状态，并且在停止完成后更新为已停止（STOP_SUCCESS）状态。

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 subtasks Array of Real3DSubTaskDto objects 精修后处理任务列表。 page Page object 分页信息。 表5 Real3DSubTaskDto 参数 参数类型 描述 subtask_id String 实景三维精修后处理任务ID。 task_id String 原始实景三维建模任务ID。 subtask_name String 精修后处理任务别名。 task_name String 原始实景三维建模任务名称。 workspace_id String 原始实景三维建模任务所属工作共享空间ID。 modeling_params ModelingParams object 原始实景三维建模任务建模参数列表。 subtask_status String 实景三维精修后处理任务当前状态。 INIT（初始化） UPLOADING（上传中） UPLOAD_SUCCESS（上传成功） UPLOAD_FAILED（上传失败） PENDING（等待中） STARTING（启动中） START_FAILED（启动失败） RUNNING（运行中） SUCCESS（运行成功） FAILED（运行失败） STOPPING（停止中） STOP_SUCCESS（已停止） model_path String 模型数据上传路径。 refine_product_id String 精修后处理任务成果数据ID。 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。 creator String 精修后处理任务创建人。 latest_operator String 精修后处理任务最近操作人。 subtask_progress String 精修后处理任务进度。该字段为保留两位小数的浮点型数值字符串，数值表示范围为0.00~1.00。 exec_start_time String 精修后处理任务执行开始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 exec_stop_time String 精修后处理任务执行结束时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 fail_message String 失败消息。当精修后处理任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。 表6 ModelingParams 参数 参数类型 描述 accuracy String 空三精度。取值包括：Highest、High、Medium、Low、Lowest。 缺省值：High key_point_limit Integer 空三关键点数量。取值范围：1000~1000000。 缺省值：40000 tie_point_limit Integer 空三连接点数量。取值范围：100~100000。 缺省值：4000 mesh_accuracy Integer Mesh重建质量。枚举值： 0：高 1：中 2：低 缺省值：0 表7 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 该请求分页查询任务ID为914305233ef7428e8073a95d8042fxxx的精修后处理任务列表，从第0个任务开始，查询2个任务。 https://{endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx/subtasks?limit=2&offset=0

响应示例 状态码： 200 请求成功。 { "subtasks" : [ { "subtask_id" : "914305233ef7428e8073a95d8042fxxx", "task_id" : "aaaaa30b6c5f42cfaf49e01eb690xyyy", "subtask_name" : "精修后处理任务别名", "task_name" : "测试任务1685087027834", "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx", "modeling_params" : { "accuracy" : "High", "key_point_limit" : "40000", "tie_point_limit" : "4000", "mesh_accuracy" : "0" }, "subtask_status" : "INIT", "model_path" : "obs://real3d/real3d/xxx", "refine_product_id" : "914305233ef7428e8073a95d8042fxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:52:58Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "subtask_progress" : null, "exec_start_time" : null, "exec_stop_time" : null, "fail_message" : null } ], "page" : { "offset" : 0, "limit" : 2, "total" : 1 } }

URI GET /v1/real3d/{workspace_id}/tasks/{task_id}/subtasks 表1 路径参数 参数 是否必选 参数类型 描述 workspace_id 是 String 工作共享空间ID。 task_id 是 String 原始实景三维建模任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 分页大小。 最小值：1 最大值：100 缺省值：10 subtask_id 否 String 精修后处理任务ID。 subtask_name 否 String 精修后处理任务别名，支持模糊查询。 subtask_status 否 Array 根据精修后处理任务状态查询，支持输入多个状态。 create_time_from 否 String 创建精修后处理任务的起始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 create_time_to 否 String 创建精修后处理任务的截止时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time_from 否 String 更新精修后处理任务的起始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time_to 否 String 更新精修后处理任务的截止时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

功能介绍 对单个实景三维建模任务内的精修后处理任务进行分页查询，支持过滤条件： 实景三维精修后处理任务ID（subtask_id）：支持根据ID查询特定精修后处理任务。 实景三维精修后处理任务别名（subtask_name）：支持根据精修后处理任务别名进行模糊查询。 实景三维精修后处理任务状态（subtask_status）：支持同时查询多种状态的精修后处理任务。 实景三维精修后处理任务创建时间范围（create_time_from和create_time_to）：为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 实景三维精修后处理任务更新时间范围（update_time_from和update_time_to）：为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 分页参数：偏移量offset（缺省值为0）、每页数量limit（缺省值为10）。

计费说明 KooMap服务各个子服务的计费项如表1所示。 表1 计费项信息 服务 计费项 计费项说明 适用的计费模式 计费公式 卫星影像生产服务 时空专属存储 按实际存储数据（包括原始卫星影像、生产资料、成果影像、矢量数据）占用量计费，以GB为单位进行计费。 计费周期：实时计费 ，按小时结算。 按需计费 影像数据存储量（GB） * 单价（元/GB） * 小时 基础处理：色彩增强与粗纠正L2 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：色彩增强与精纠正L3 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：正射纠正L4 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：影像镶嵌L5 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 实景三维生产服务 时空专属存储 按实际存储数据（包括倾斜影像、生产资料、精修后处理任务的输入数据、数据生产过程中产生的中间数据、成果数据）占用量计费，以GB为单位进行计费。 计费周期：实时计费 ，按小时结算。 按需计费 实际存储数据存储量（GB） *单价（元/GB）*小时 实景三维生产服务基础版 按实际数据处理量计费，以GP为单位进行计费。 按需计费 倾斜影像像素数量（GP）*单价（元/GP） 实景三维生产服务专业版 按实际数据处理量计费，以GP为单位进行计费。 按需计费 倾斜影像像素数量（GP）*单价（元/GP） AR地图运行服务 AR地图运行服务基础版 按实际开通时长计费，以小时为单位进行计费。 按需计费 资源规格对应的单价*开通时长 说明： KooMap AR地图运行服务根据您使用的规格和时长进行计费，提供50QPS ~ 500QPS总共10档资源规格。例如50QPS表示每秒支持50个用户并发。 AR地图生产服务 AR地图全景建图云服务 按实际数据处理量（采图轨迹长度）计费，以米为单位进行计费。 按需计费、套餐包 按需计费：采图轨迹长度（米）*单价（元/米） 套餐包：从套餐包的长度总量中扣除相应的轨迹长度（米），超出部分按需计费

修订记录 发布日期 修订记录 2024-05-17 第九次公测发布： 权限管理：增加实景三维生产服务精修后处理相关的权限操作。 2024-04-08 第八次公测发布： 什么是云地图服务：在产品特点、产品功能以及产品架构章节中增加AR地图生产服务的内容。 应用场景：增加AR地图生产服务的应用场景。 约束与限制：增加AR地图生产服务的约束与限制。 基本概念：增加AR地图生产服务相关概念描述。 2023-12-28 第七次公测发布： 什么是云地图服务：在产品特点、产品功能、产品优势以及产品架构章节中增加实景三维生产服务的内容。 应用场景：增加实景三维生产服务的应用场景。 身份认证与访问控制：实景三维生产服务支持Token认证。 权限管理：增加实景三维生产服务相关的权限操作列表。 约束与限制：增加实景三维生产服务的约束与限制。 与其他服务的关系：增加实景三维生产服务的相关描述。 基本概念：增加实景三维生产服务相关概念描述。 2023-11-17 第六次公测发布： 权限管理：优化权限操作列表。 与其他服务的关系：优化描述。 2023-07-03 第五次公测发布： 访问方式：增加SDK访问方式。 约束与限制：修改成果影像约束与限制描述。 2023-04-27 第四次公测发布： 什么是云地图服务：在产品特点、产品功能以及产品架构章节中增加AR地图运行服务的内容。 产品优势：增加了AR地图运行服务的产品优势。 应用场景：增加AR地图运行服务的应用场景。 基本概念：增加“视觉定位”和“AR导航”的概念描述。 2023-04-25 第三次公测发布： 什么是云地图服务：更新子功能项的功能概述。 应用场景：更新服务应用场景描述。 安全：增加“安全”章节。 约束与限制：增加当L1级影像成像倾斜角＞15°时，成果影像的接边误差限制。 2023-03-10 第二次公测发布。 什么是云地图服务：增加“色彩增强与精纠正L3处理”功能。 应用场景：更新应用场景描述。 权限管理：在表2增加生产资料的操作权限。 2022-12-27 第一次公测发布。

KooMap FullAccess策略内容 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "KooMap:*:*" ] } ] }