实景三维-华为云

云地图服务 KOOMAP-查询实景三维用量:响应示例

响应示例状态码： 200 请求成功。 { "data" : [ { "usage_measure_name" : "时空专属存储", "usage_type" : "DATA", "domain_id" : "abc123c55c3c4526b2ed7a0213bc9xxx", "usage_subtype" : "REAL3D_BASIC", "usage_unit_type" : "VOLUME", "capacity" : 0, "usage" : 0, "unit" : "GB", "created_time" : "2022-10-27T13:12:56Z", "update_time" : "2022-10-27T13:12:56Z" } ] }

云地图服务 KOOMAP 实景三维用量统计

云地图服务 KOOMAP-查询实景三维用量:功能介绍

功能介绍您可以查看实景三维生产服务时空专属存储或影像建模的用量统计。时空专属存储：包括用户上传的数据、数据生产过程中产生的中间数据以及实景三维模型成果数据的存储总量。用户上传的数据：倾斜摄影影像（航空飞机影像和无人机影像）、生产资料、精修后处理任务的输入数据（精修前后的obj数据）。数据生产过程产生的中间数据：空三、显式辐射场阶段产生的数据。实景三维成果数据：纹理Mesh实景三维模型和显式辐射场实景三维模型的osgb、obj格式的文件。影像建模用量：统计成功建模的倾斜影像的像素数量（单位为“GP”，即十亿像素）、成功建模的次数。

云地图服务 KOOMAP 实景三维用量统计

云地图服务 KOOMAP-查询实景三维用量:响应参数

响应参数状态码： 200 表3 响应Header参数参数参数类型描述 X-request-id String 请求ID，用于运维人员定位请求日志。表4 响应Body参数参数参数类型描述 data Array of UsageVo objects 用量信息列表。表5 UsageVo 参数参数类型描述 usage_measure_name String 用量度量名称，通常与KooMap的计费项保持一致。当前支持以下用量度量名称：时空专属存储实景三维生产服务基础版实景三维生产服务专业版 usage_type String 用量类型。该值为“DATA”时表示时空专属存储对应的用量消耗。该值为“REAL3D”时表示处理三维建模任务对应的用量消耗。 domain_id String 华为云 IAM 租户账号ID。最小长度：32 最大长度：32 usage_subtype String 用量子类型，用于区分同一用量类型下的多个子用量，目前usage_type为“REAL3D”时才需要设置该值。 REAL3D_BASIC：实景三维生产服务基础版用量 REAL3D_PRO：实景三维生产服务专业版用量 usage Float 租户当前的使用量数值。 capacity Float 租户购买的套餐总量值，按需使用取值为0。 usage_unit_type String 用量的计量单位类型。 “VOLUME”：容量。 “NUMBER”：数量。 “COUNT”：次数。 unit String 用量的计量单位。当用量单位类型为“VOLUME”时，单位为存储量相关的单位，如：GB。当用量单位类型为“NUMBER”时，单位为十亿像素（GP）。当用量单位类型为“COUNT”时，单位为“次”。 created_time String 用量记录的创建时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time String 用量记录的更新时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。状态码： 400 表6 响应Header参数参数参数类型描述 X-request-id String 请求ID，用于运维人员定位请求日志。表7 响应Body参数参数参数类型描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。最小长度：12 最大长度：12 error_msg String 错误描述。最小长度：2 最大长度：512 状态码： 500 表8 响应Header参数参数参数类型描述 X-request-id String 请求ID，用于运维人员定位请求日志。表9 响应Body参数参数参数类型描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。最小长度：12 最大长度：12 error_msg String 错误描述。最小长度：2 最大长度：512

云地图服务 KOOMAP 实景三维用量统计

云地图服务 KOOMAP-删除实景三维成果数据:响应参数

响应参数状态码： 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

云地图服务 KOOMAP 实景三维数据管理

云地图服务 KOOMAP-创建实景三维建模任务:响应示例

响应示例状态码： 200 请求成功。 { "task_id" : "914305233ef7428e8073a95d8042xxxx", "task_name" : "测试任务1685087027834", "task_type" : "REAL3D-UNCTRL", "modeling_type" : "Nerf", "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx", "modeling_params" : { "accuracy" : "High", "key_point_limit" : "40000", "tie_point_limit" : "4000", "mesh_accuracy" : "0" }, "coordinate_sys" : "WGS84-UTM", "has_marker" : false, "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:43:47Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "task_status" : "INIT", "complete_stage" : null, "total_stage" : null, "exec_start_time" : null, "task_progress" : null, "exec_stop_time" : null, "fail_message" : null, "AT_progress" : null }

云地图服务 KOOMAP 实景三维任务管理

云地图服务 KOOMAP-创建实景三维建模任务:请求示例

请求示例该请求示例用于创建一个REAL3D-UNCTRL（无控建模）任务。 POST https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks { "task_name" : "测试任务", "task_description" : "测试任务", "task_type" : "REAL3D-UNCTRL", "modeling_type" : "Nerf", "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx", "coordinate_sys" : "WGS84-UTM" }

云地图服务 KOOMAP 实景三维任务管理

云地图服务 KOOMAP-创建实景三维建模任务:响应参数

响应参数状态码： 200 表5 响应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（运行中） SUC CES S（运行成功） 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。表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 状态码： 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

云地图服务 KOOMAP 实景三维任务管理

云地图服务 KOOMAP-创建实景三维建模任务:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。表3 请求Body参数参数是否必选参数类型描述 task_name 是 String 任务名称。支持中文、英文、数字以及“_”字符，长度限制1~50个字符。 task_description 否 String 任务描述。支持中文、英文、数字以及“_”字符，长度限制255个字符以内。 task_type 否 String 任务类型。 REAL3D-CTRL：实景三维有控建模 REAL3D-UNCTRL：实景三维无控建模 modeling_type 否 String 建模类型。 Mesh：纹理模型实景三维建模。 Nerf：显式辐射场实景三维建模。 modeling_params 否 ModelingParams object 实景三维建模参数。当请求体中modeling_params为null或者未配置时，其属性均使用缺省值。当请求体中modeling_params不为null时，则其属性均为必填项，不能省略。 folder_code 否 String 需要进行三维重建的倾斜影像的影像code。 coordinate_sys 否 String 建模坐标系。坐标系当前仅支持WGS84-UTM。输入为null或者不填时，均使用缺省值WGS84-UTM。表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

云地图服务 KOOMAP 实景三维任务管理

云地图服务 KOOMAP-创建实景三维精修后处理任务:响应参数

响应参数状态码： 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

云地图服务 KOOMAP 实景三维精修后处理任务管理

云地图服务 KOOMAP-创建实景三维精修后处理任务:响应示例

响应示例状态码： 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 }

云地图服务 KOOMAP 实景三维精修后处理任务管理

云地图服务 KOOMAP-新增图片上的刺点:请求参数

请求参数表1 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。表2 请求Body参数参数是否必选参数类型描述 imageCode 是 String 图片ID。 taskId 是 String 刺点所属任务ID。 pointWidth 是 String 刺点在图片中的横向像素值，以分块左上角为原点，不能超过图片范围。 pointHeight 是 String 刺点在图片中的纵向像素值，以分块左上角为原点，不能超过图片范围。 longitude 是 String 像控点经度。范围：[-10000000, 10000000]。 latitude 是 String 像控点纬度。范围：[-10000000, 10000000]。 height 是 String 像控点高度。范围：[-10000000, 10000000]。 accuracy 是 String 像控点精度。范围：(0, 100)。

云地图服务 KOOMAP 实景三维刺点管理

云地图服务 KOOMAP-新增图片上的刺点:响应示例

响应示例状态码： 200 请求成功。 { "imageCode" : "1674019035390013440", "id" : "1676151290921086976", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }

云地图服务 KOOMAP 实景三维刺点管理

云地图服务 KOOMAP-新增图片上的刺点:请求示例

请求示例该请求在图片中新建一个刺点。 POST https://{Endpoint}/v1/real3d/spur { "imageCode" : "1674019035390013440", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }

云地图服务 KOOMAP 实景三维刺点管理

云地图服务 KOOMAP-新增图片上的刺点:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 imageCode String 图像ID。 id String 刺点ID。 taskId String 刺点所属任务ID。 pointWidth String 刺点在图片中的横向像素值。 pointHeight String 刺点在图片中的纵向像素值。 longitude String 像控点经度。 latitude String 像控点纬度。 height String 像控点高度。 accuracy String 像控点精度。状态码： 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

云地图服务 KOOMAP 实景三维刺点管理

云地图服务 KOOMAP-导入倾斜影像数据:（可选）导入生产资料

（可选）导入生产资料创建实景三维建模任务时，如“任务类型”选择“有控建模”才需要导入生产资料。登录KooMap服务控制台，进入控制台页面。在左侧导航栏选择“实景三维”下的“数据管理”菜单，在右侧的“生产资料”页签中单击“导入生产资料”。在“导入生产资料”弹窗中，参考表3填写待导入生产资料文件的信息。表3 导入生产资料文件说明序号参数名称参数说明 1 导入方式必选项，仅支持从本地上传生产资料。说明：支持文件格式为.txt文件，应仅含有一个文件，且文件大小应小于60MB。 2 上传文件必选项，单击“选择文件”，依照系统提示上传本地生产资料文件。 3 生产资料别名必填项，依照系统提示输入生产资料别名，不可与已有别名重复。 4 生产资料描述选填项，主要描述导入生产资料文件的补充信息，输入要求请查看界面提示。单击“确定”，导入生产资料文件。导入成功后，生产资料会在列表显示。图2 导入生产资料

云地图服务 KOOMAP 实景三维操作指导

云服务器内容精选

实景三维

7*24

备案

专业服务

退订

建议反馈

售前咨询热线