华为云用户手册

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

KooMap权限 默认情况下，新建的 IAM 用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 如表1所示，包括了KooMap的所有系统策略。 表1 KooMap系统策略 策略名称 描述 策略类别 策略内容 KooMap FullAccess KooMap服务的所有权限。 系统策略 KooMap FullAccess策略内容 表2列出了KooMap常用操作与系统策略的授权关系。 “√”表示支持。 表2 KooMap操作与系统策略授权关系 服务 操作 KooMap FullAccess 卫星影像生产服务/实景三维生产服务 创建工作共享空间 √ 修改工作共享空间 √ 删除工作共享空间 √ 查询工作共享空间列表 √ 卫星影像生产服务 创建卫星影像生产任务 √ 查询卫星影像生产任务列表 √ 查询卫星影像生产任务概览 √ 启动卫星影像生产任务 √ 停止卫星影像生产任务 √ 归档已完成的卫星影像生产任务 √ 删除卫星影像生产任务 √ 校验影像数据文件 √ 查询用量情况 √ 查询影像基本信息 √ 查询矢量数据文件（shape格式）基本信息 √ 上传矢量数据文件（shape格式） √ 查看影像元数据 √ 下载矢量数据文件（shape格式） √ 下载影像数据文件 √ 迁入影像数据文件 √ 迁出影像数据文件 √ 查看待迁出的影像数据文件列表 √ 检查迁出影像数据文件时的输入参数 √ 查看待迁出的矢量数据文件（shape格式） √ 迁出矢量数据文件（shape格式） √ 迁入矢量数据文件（shape格式） √ 删除影像数据文件 √ 删除矢量数据文件（shape格式） √ 上传生产资料文件（csv格式） √ 删除生产资料文件（csv格式） √ 查询生产资料文件（csv格式）基本信息 √ 实景三维生产服务 新增倾斜摄影影像导入任务 √ 查看倾斜摄影影像导入中的任务列表 √ 编辑倾斜摄影影像导入任务 √ 删除倾斜摄影影像导入任务 √ 启动倾斜摄影影像导入任务 √ 查询倾斜摄影影像列表 √ 删除倾斜摄影影像 √ 查看倾斜摄影影像包含的图片信息 √ 查询实景三维任务列表 √ 创建实景三维任务 √ 删除实景三维任务 √ 更新实景三维任务 √ 归档/取消归档实景三维任务 √ 展示工作共享空间内实景三维任务概览 √ 启动实景三维任务 √ 停止实景三维任务 √ 查询实景三维成果影像列表 √ 删除实景三维成果影像列表 √ 获取成果影像下载链接列表 √ 查询实景三维用量 √ 查询租户开通资源 √ 开通实景三维生产服务 √ 关闭实景三维生产服务 √ 新增实景三维影像刺点 √ 删除实景三维影像刺点 √ 查询实景三维影像刺点 √ 预测刺点信息 √ 上传像控点文件 √ 查询像控点文件 √ 删除像控点文件 √

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏选择“工作共享空间管理”，然后在右侧页面单击工作共享空间名称。 单击“卫星影像概览”页签，进入卫星影像概览页。 图1 卫星影像概览页 在卫星影像概览页，您可参考表1操作任务。 表1 操作任务与操作步骤 操作 操作步骤 适用任务的状态 查询任务 方式一：单击页面左上角任务状态统计环，下方显示对应状态的全部任务。 所有状态（包括未运行、失败、执行中、停止中、等待中、执行成功、停止成功、已归档） 方式二：设置过滤条件查询任务。 在右上角设置任务名称、创建任务时间区间以及任务状态作为过滤条件。 单击或按回车键，界面显示符合过滤条件的全部任务。 说明： 当选择“运行态”或“成功”状态时，可选状态分别如下： 运行态：可选择“停止中”、“等待中”和“执行中”。 成功：可选择“停止成功”和“执行成功”。 启动/重启任务 单击任务卡片中的启动数据处理任务。 说明： 处理时长依赖您选择的待处理数据大小、数量、复杂度、处理等级等因素，耗时可能比较久，请您耐心等待。 未运行、停止成功、失败 停止任务 单击任务卡片中的停止数据处理任务。 执行中、等待中 归档任务 单击任务卡片中的归档任务。 执行成功 解除归档任务 单击任务卡片中的解除归档任务。 已归档 查看成果数据 单击任务卡片中的“查看成果数据”。 跳转到“卫星影像”下的“数据管理”页面。 查看成果数据。 说明： 创建任务时，如果“处理等级”选择“L5”且勾选“金字塔切割”或“矢量切割”，“卫星影像”页面中的“影像等级”列分别用或标识。 执行成功 删除任务 单击任务卡片右上角 。 单击“确定”，完成任务的删除。 失败、未运行、执行成功、停止成功

导入倾斜影像 倾斜摄影影像数据是无人机或航空飞机拍摄的框幅式影像，采集方式为倾斜摄影（非贴近或绕拍方式），影像格式支持.jpg、.jpeg、.JPG或.JPEG格式，单张影像的像素总数不超过2.5亿，总影像张数建议不超过30万张。 存放在OBS的倾斜摄影的影像数据需包含5个文件夹，分别存放无人机或航空飞机拍摄的前视图、后视图、左视图、右视图以及俯视图影像。 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“实景三维”下的“数据管理”菜单，然后在右侧页面单击“倾斜影像”页签。 单击“导入影像”，进入“导入影像文件”页面。参考表1配置影像文件信息。 表1 导入倾斜影像参数说明 参数名称 参数说明 OBS Endpoint 必填项，输入OBS桶所在区域的终端节点，可参考查看桶信息获取。 影像目录地址 必填项，输入上传到OBS桶的原始影像文件所在的文件夹路径（可直接进入OBS控制台复制OBS的文件路径），不可与已有地址重复。 目录地址格式为：obs://桶名/影像文件所在的文件夹路径。 示例：obs://obstest-ea7e/path 影像名称 无需手动输入，导入的影像名称须为全英文，系统会根据您导入的影像自动识别名称。 影像别名 必填项，依照界面提示输入影像的别名，不可与已有别名重复。 影像描述 选填项，主要描述导入影像的补充信息。 编辑源数据文件。 拖拽右侧长方形方框至左侧对应视图区域，直至完成所有视图匹配。 （可选）您可根据实际需求单击各个视图下方的编辑相机参数，参数包括相机名称、相机类型（只支持填写Frame）、焦距、X方向光心偏移、Y方向光心偏移以及畸变参数，参数说明见表2。 相机参数用于实景三维建模，使得建模后的成果数据更加符合您的实际需求。 图1 编辑源数据文件 表2 相机参数说明 参数 说明 备注 相机名称 必填项。 输入拍摄影像的相机名，且拍摄各视图的相机名称不可重复。 - 相机类型 必填项。 输入拍摄影像的相机类型，目前只支持“Frame”。 - 焦距（focus） 可填项。 输入相机焦距。 数据范围：[1, 1000000] - X方向光心偏移 可填项。 输入X方向光心偏移量。 数据范围：[1, 8192] 光心偏移是指光学中心与机械中心的偏移量。 Y方向光心偏移 可填项。 输入Y方向光心偏移量。 数据范围：[1, 8192] 畸变参数（k1） 可填项。 输入径向畸变参数k1。 数据范围：[-100, 100] 径向畸变参数是指图像中心与边缘的比例失真。 畸变参数（k2） 可填项。 输入径向畸变参数k2。 数据范围：[-100, 100] 畸变参数（k3） 可填项。 输入径向畸变参数k3。 数据范围：[-100, 100] 畸变参数（k4） 可填项。 输入径向畸变参数k4。 数据范围：[-100, 100] 畸变参数（p1） 可填项。 输入切向畸变参数p1。 数据范围：[-100, 100] 切向畸变参数是指图像中心与边缘的图像失真。畸变参数越小，图像失真越小，图像质量越高。 畸变参数（p2） 可填项。 输入切向畸变系数p2。 数据范围：[-100, 100] 畸变参数（b1） 可填项。 输入像平面畸变参数b1。 数据范围：[-100, 100] - 畸变参数（b2） 可填项。 输入像平面畸变参数b2。 数据范围：[-100, 100] - 单击，将影像文件添加到列表中。 单击“导入”，导入单个影像文件。 您还可以删除、编辑影像文件。 删除：从列表中删除影像文件。 编辑：重新设置影像文件信息。编辑完成后单击“保存”，可覆盖原始影像文件记录。 查看导入结果。 选择“卫星影像”下的“数据管理”菜单，然后单击“影像数据”页签，查看该倾斜影像导入情况。影像导入过程中，“处理状态”为“处理中”，导入成功后，“处理状态”变更为“完成”。

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

（可选）导入矢量数据 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“矢量数据”页签。 单击“导入矢量”，出现“导入矢量文件”弹窗。 填写或选择导入矢量文件的信息，相关说明可参考下表3。 表3 导入矢量参数说明 序号 参数名称 参数说明 1 导入方式 必选项，选择矢量文件的导入方式，选项如下： 矢量文件地址导入（小于2GB） 说明： 支持的文件格式有：.dbf、.shp、.shx、.prj、.sbn、.sbx、.cpg、.qpj、.xml、.qmd，至少应含有.dbf、.prj、.shp、.shx四个文件。文件大小之和应小于2GB，请上传文件名相同的文件。 本地矢量文件上传（小于60MB） 说明： 支持的文件格式有：.dbf、.shp、.shx、.prj、.sbn、.sbx、.cpg、.qpj、.xml、.qmd，至少应含有.dbf、.prj、.shp、.shx四个文件。文件大小之和应小于60MB，请上传文件名相同的文件。 2 OBS Endpoint 必填项，当导入方式选择“矢量文件地址导入”显示该项参数。输入OBS桶所在区域的终端节点，可参考查看桶信息获取。 3 矢量目录地址 必填项，当导入方式选择“矢量文件地址导入（小于2GB）”时才显示该参数。 获取方式：进入OBS管理控制台复制矢量文件所在的文件夹路径。 目录地址格式为：obs://桶名/矢量文件所在的文件夹路径。 示例：obs://obstest-ea7e/path 4 上传文件 必填项，当导入方式选择“本地矢量文件上传（小于60MB）”时才显示该参数，单击“选择文件”上传本地矢量文件。 5 矢量别名 必填项，根据界面提示输入矢量别名，且不能与系统已有别名重复。 6 矢量描述 选填项，主要描述导入矢量文件的补充信息，输入要求请查看界面提示。 图4 矢量文件地址导入 图5 上传本地矢量文件 单击“确定”，导入矢量数据。 导入后，选择“卫星影像”下的“数据管理”菜单，然后单击“矢量数据”页签，查看该矢量数据导入情况。导入过程中“运行状态”为“迁入中”，导入成功后，“运行状态”变更为“完成”。 图6 导入矢量数据

（可选）导入生产资料 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“生产资料”页签。 单击“导入生产资料”，出现“导入生产资料文件”弹窗。 填写或选择导入生产资料文件的信息，包括导入方式、上传文件、生产资料别名、生产资料描述（相关说明可参考下表4）。 表4 导入生产资料文件说明 序号 参数名称 参数说明 1 导入方式 必选项，仅支持从本地上传生产资料（小于60MB）。 2 上传文件 必选项，单击“选择文件”，依照系统提示上传本地生产资料文件。 3 生产资料别名 必填项，依照系统提示输入生产资料别名，不可与已有别名重复。 4 生产资料描述 选填项，主要描述导入生产资料文件的补充信息，输入要求请查看界面提示。 单击“确定”，导入生产资料文件。导入成功后，“运行状态”变更为“加密完成”。 图7 导入生产资料

导入卫星影像 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签。 添加影像文件。 单击“导入影像”，您可选择如下任一方式添加影像文件到列表中。 单个添加：参考表1配置影像文件信息，单击，将影像文件添加到“已添加的影像文件”列表中。如果需导入多个目录地址的影像文件，请您分别配置影像文件信息，并单击添加到列表中。 图1 设置影像文件信息 批量添加：单击页面右上角的“下载模板”，依照模板提示或参考表1配置影像文件信息，再单击“上传Excel”批量添加影像文件。 表1 导入影像参数说明 参数名称 参数说明 OBS Endpoint 必填项，输入OBS桶所在区域的终端节点，可参考查看桶信息获取。 影像目录地址 必填项，输入上传到OBS桶的原始影像文件所在的文件夹路径（可直接进入OBS控制台复制OBS的文件路径），不可与已有地址重复。 目录地址格式为：obs://桶名/影像文件所在的文件夹路径。 示例：obs://obstest-ea7e/path 影像名称 无需手动输入，系统会根据您导入的影像自动识别名称。 影像别名 必填项，依照界面提示输入影像的别名，不可与已有别名重复。 影像描述 选填项，主要描述导入影像的补充信息。 图2 已添加的影像文件 导入影像文件。 单个导入：在“已添加的影像文件”列表中单击操作列的“导入”，导入单个影像文件。 您还可以执行删除、编辑、重试操作。 删除：从列表中删除影像文件。 编辑：重新设置影像文件信息。该影像文件会从当前列表中删除，编辑完成后可再次添加到“已添加的影像文件”列表中。 重试：导入失败，排查原因并修改后，重新导入影像文件。 批量导入：单击页面最下方的“开始批量导入”按钮，批量导入“已添加的影像文件”列表中的影像文件。 在“已添加的影像文件”列表中，如果该影像文件处理结果提示“文件名校验失败”，请单击操作列或页面右上角的“命名辅助工具”，参考表2配置参数，根据生成的文件夹和文件名称修改OBS桶内文件夹与文件名称，并重新执行1~4。 表2 命名辅助工具参数说明 参数 说明 卫星名 必填项，输入卫星名，卫星名前缀不能为GF1、GF2、GF6、GF7、JL1、TRIPLESAT、BJ3、SV1、SV2、ZY1、ZY3、SJ9A、PHR1A、PHR1B、WV01、WV02、TH01，仅支持输入字母和数字，不能超过100个字符。 传感器名 必选项，选择传感器名称。目前仅支持如下传感器名称： MSS PAN 成像日期 必选项，设置卫星影像的成像日期。 中心经度 必填项，输入卫星影像中心经度。E/W开头（不区分大小写），经度保留一位小数，如E23.0。 中心纬度 必填项，输入卫星影像中心纬度。N/S开头（不区分大小写），纬度保留一位小数，如N23.0。 等级 必选项，选择卫星影像等级，目前仅支持“L1”等级。 文件夹名称 系统依照上面设置的信息，自动拼接文件夹名称。单击可复制文件夹名称。 文件夹 展示文件夹中的目录文件。您可以根据生成的结果去修改本地影像文件夹与文件名称。 说明： 文件夹名称与文件名称须保持一致。 文件夹内必须包含 .tif/.tiff、.rpc/.rpb、.xml三种后缀名的文件。 查看导入结果。 导入后，在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签，可查看该影像文件导入情况，导入过程中“运行状态”为“迁入中”，导入成功后，“运行状态”变更为“完成”。 图3 导入卫星影像

修订记录 发布日期 修订记录 2024-04-08 第十一次公测发布。 新增AR地图操作指导。 2023-12-28 第十次公测发布。 入门指引：增加实景三维生产服务相关描述。 实景三维操作指导：新增该章节。 2023-11-17 第九次公测发布。 新建工作共享空间： 修改每个租户下创建工作共享空间的上限值。 表1中删除“空间类型”参数。 处理影像数据： 在“查看成果数据”的操作步骤中增加说明。 增加“执行成功”状态下的任务可被删除的相关描述。 2023-05-30 第八次公测发布。 处理影像数据：在“查看成果数据”的操作步骤中增加说明。 导入数据：更新导入卫星影像图片。 2023-04-25 第七次公测发布。 导入数据：新增命名辅助工具内容描述，删除影像供应商相关内容描述以及更新相关图片。 创建任务：更新带有供应商字段的相关图片。 2023-03-29 第六次公测发布。 导入数据：新增适配的卫星型号SJ9A。 创建任务：新增国家2000、国家2000-GaussKruger坐标系相关操作描述。 2023-03-10 第五次公测发布。 导入数据：更新支持的影像供应商型号和新增导入生产资料的操作描述。 创建任务：新增L3处理等级和导入生产资料操作描述。 处理影像数据：更新图1 任务概览页和表1 操作任务与操作步骤。 查看用量统计：更新卫星影像生产服务用量的统计内容与相关图片。 2023-02-03 第四次公测发布。 导入数据：新增四维测绘支持的卫星型号和更新相关图片。 2023-01-18 第三次公测发布。 导入数据：删除“导入影像参数说明”表格有关坐标系的描述。 创建任务：新增坐标系的描述。 2023-01-11 第二次公测发布。 导入数据：新增导入参数的提示信息。 新建工作共享空间：更新功能参数的名称。 创建任务：新增卫星影像文件的选择规则以及更新图片。 处理影像数据：更新概览页图片。 查看用量统计：更新导航路径与图片。 2022-12-27 第一次公测发布。

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏中选择“工作共享空间管理”，查找并单击您创建的实景三维工作共享空间名称，进入工作共享空间界面。 图1 进入工作共享空间 选择“实景三维概览”页签，单击，进入创建任务界面。 参考表1填写任务和空三基本信息。 图2 填写任务信息 表1 任务基本信息 任务项 功能概述 任务名称 必填项，依据界面提示填写任务名称。 建模类型 必选项，选择建模类型。 纹理模型实景三维：对多视角影像进行分布式并行处理，生成带纹理的三维Mesh模型数据。支持影像畸变较正，纹理贴图、纹理图匀光匀色，降低影像畸变对精度的影响以及数据采集光照差异造成的色彩不均匀的问题。 显式辐射场实景三维：支持照片级重建，空间测量，真实还原多视角光影效果，显著提升模型真实感。支持业界主流渲染引擎的实时渲染，无额外适配成本。 空三精度设置 必选项，选择空三精度设置等级。更高的精度设置有助于获得更准确的相机位置估计，较低的精度设置可用于在较短的时间内获得相机位置的粗略估计。 Highest：表示设置精度为最高。 High：表示设置精度为高。 Medium：表示设置精度为中。 Low：表示设置精度为低。 Lowest：表示设置精度为最低。 默认值：High。 空三关键节点数量 必填项，依据实际填写实景三维生产任务的关键节点数量。 只允许输入数字，取值范围为：1000~1000000 默认值：无。 空三连接点数量 必填项，依据实际填写实景三维生产任务的连接点数量。连接点是指两张或者多张照片中投影于同一地面点的像素。 只允许输入数字，取值范围为：100~100000 默认值：无。 重建质量 必选项，依据实际选择实景三维任务的重建质量级别。级别越高，质量越好。 高：表示设置空三连接点数量为高。 中：表示设置空三连接点数量为中。 低：表示设置空三连接点数量为低。 默认值：高。 任务描述 必填项，请依照界面提示输入内容。 单击“下一步”，进入处理数据操作。 选择任务类型。 依照实际需求选择任务类型（无控建模、有控建模），各任务类型对应的处理项目请参考表2。 表2 任务类型项目列表 任务类型 功能概述 无控建模 实景三维建模过程中不需要进行人工刺点操作。 有控建模 实景三维建模过程中需要选择生产资料，需在处理影像数据完成刺点编辑。 选择坐标系。选择导入的影像坐标系，当前仅支持：WGS84-UTM。 选择待选数据。根据需要选择待处理的实景三维倾斜影像。 确认无误后单击“确定”，任务创建成功。您可在实景三维概览页面查看新建的建模任务。 鼠标悬停在卡片中的任务名称处，可查看该任务相关信息。 图3 任务创建成功

概述 云地图服务 （KooMap）是一款使能数字孪生的地图服务。它汇聚了地图数据和应用生态，沉淀行业资产，打造开放平台，提供了时空数据处理、分析、可视等一站式开箱即用的时空信息服务，驱动着行业转型和创新。 云地图 服务主要由一下几个子服务组成： 卫星影像生产服务：对原始的遥感光学卫星影像进行专业处理，生成各个行业应用可使用的成果影像数据。 实景三维生产服务：利用三维重建技术，将现实采集场景快速还原为三维世界，生成支撑各行业应用数据的数字底座。 AR地图生产服务：对外业采集的图像数据进行加工处理，通过三维场景重建等自动化处理步骤，生成AR地图成果数据，供AR地图运行服务使用。 通过该手册您可以了解KooMap各子服务的基本操作流程，帮助您轻松使用本服务。

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏中选择“工作共享空间管理”，查找并单击您创建的数据处理工作共享空间名称，进入工作共享空间界面。 图1 进入工作共享空间 选择“卫星影像概览”页签，单击，进入创建任务界面。 填写任务基本信息。 可自定义任务名称，任务描述处输入任务相关补充信息。 图2 填写任务信息 单击“下一步”，进入数据选择界面。 选择处理等级。 依照实际需求选择处理等级（可选：L2、L3、L4、L5），各处理等级对应的处理项目请参考表1。 表1 处理等级处理项目列表 处理等级 功能概述 色彩增强与粗纠正L2处理 对原始卫星数据进行色彩增强与几何粗纠正处理，输出L2级的成果数据。可实现几何接边误差小于100像素。 色彩增强与精纠正L3处理 对原始卫星数据进行色彩增强与几何精纠正处理，输出L3级的成果数据。可实现几何接边误差小于10像素。 正射纠正L4处理 对原始卫星数据进行色彩增强与正射纠正处理，输出L4级的成果数据。可实现几何接边误差小于2像素。 影像镶嵌L5处理 在正射纠正L4级数据的基础上执行影像匀色、镶嵌处理，输出L5级成果数据，并支持矢量边界裁切、瓦片金字塔形式的成果输出。 当处理等级为“L3”、“L4”、“L5”时，才有“生产资料”选项。当处理等级为“L3”时，“生产资料”为必选项，其他等级则为非必选项。若勾选了“生产资料”选项，页面下方会有生产资料数据可供选择。 当处理等级为“L5”，才有“金字塔切割”和“矢量切割”选项，若勾选了“矢量切割”，页面最下方会有矢量数据可供选择。 图3 选择处理等级 选择坐标系。选择导入的影像坐标系，可选项有：WGS84、WGS84-UTM、国家2000、国家2000-GaussKruger。 当您使用“WGS84-UTM”时，可在右侧框选择具体的UTM带号。 图4 选择坐标系-1 当您使用“国家2000-GaussKruger”时，需在右侧框选择CG CS 2000坐标系对应的EPSG Code。 图5 选择坐标系-2 选择数据类型并勾选相应数据。 选择卫星影像。 选择卫星影像文件须遵守如下规则： 只处理多光谱影像：拍摄卫星只有多光谱相机（GF1-WFV或GF6-WFV），且必须选择卫星型号和传感器型号一致的影像。 处理多光谱和全色一一对应影像：必须选择卫星型号一致的影像，且多光谱和全色影像文件数量一致。 图6 选择卫星影像数据 （可选）选择生产资料。 当处理等级为“L3”、“L4”、“L5”时，才有“生产资料”选项，您可依据实际情况进行选择。其中当处理等级为L3时，“生产资料”为必选项，其余等级为非必选项。 图7 选择生产资料 （可选）选择矢量数据。 当处理等级为“L5”且勾选了“矢量切割”选项时，数据类型选择“矢量数据”，页面最下方呈现可供选择的矢量数据，您可依据实际情况进行选择。 图8 选择矢量数据 单击“下一步”，核对成果影像的信息，包括名称、别名（不可与已有别名重复）与描述。 图9 确认成果影像信息 确认无误后单击“确定”，任务创建成功。您可在“卫星影像概览”页面查看新建的任务。 图10 任务创建成功

查看用量统计 用量统计主要是对时空专属存储以及卫星影像生产服务的用量统计，您可以查看时空专属存储或各等级处理任务的用量统计。 时空专属存储：统计导入的原始卫星影像、矢量数据、生产资料和成果影像存储总量。 卫星影像生产服务用量：统计L2、L3、L4、L5等级处理的成果影像存储用量、处理成功的次数。 用量统计仅供参考，实际情况请以账单为准。 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏选择“卫星影像”下的“用量统计”菜单，然后在右侧单击“我的存储”页签，查看时空专属存储用量。 图1 时空专属存储用量统计 在左侧导航栏选择“卫星影像”下的“用量统计”菜单，然后在右侧单击“卫星影像生产服务”页签，查看所有处理等级的成果影像存储用量、成功处理的次数。 图2 卫星影像生产服务用量统计 父主题： 卫星影像操作指导

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“AR地图”下的“项目管理”菜单，进入“项目管理”页面。 在“项目管理”页面，单击项目名称（蓝色字体），进入该项目详情页。 单击“上传数据”，根据表1填写待上传数据的相关信息。 表1 上传数据配置参数 配置项 配置说明 数据名称 必填项。 输入数据名称。 名称不可重复。 数据类型 必选项。 目前仅支持“Insta360”。 上传数据 单击“上传文件夹”上传本地的全景视频。 如果上传数据选择错误，可删除重新上传。 数据描述 选填项。 输入待上传数据的相关描述。 单击“确定”，开始上传数据。 上传数据完成后，显示“完成”对话框。 您可以对正在上传的数据做如下操作： 查看全部：单击此按钮查看上传的全部数据。 查看激活的：单击此按钮查看当前任务下正在上传的文件上传进度。 继续上传：状态为“失败”时（断网、异常关机、刷新或重启浏览器等情况导致），单击此按钮重新选择数据上传。 移除：取消上传操作后，单击此按钮移除该数据。 取消：单击此按钮取消上传数据。

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“AR地图”下的“项目管理”菜单，进入“项目管理”页面。 在“项目管理”页面，单击项目名称（蓝色字体），进入该项目详情页。 选择注册成功的数据，单击操作列下的“注册调整”，在“注册调整”弹窗内核对地图注册结果。 如果注册结果不符合要求，可手动调整注册结果的坐标位置及角度。 图1 注册调整 单击“确定”进行地图生成。 地图生成完成后，“地图生成”列显示为“生成成功”。

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“AR地图”下的“项目管理”菜单，进入“项目管理”页面。 在“项目管理”页面，单击项目名称（蓝色字体），进入该项目详情页。 选择预处理成功的数据，单击操作列下的“提交生产”。 图1 预览轨迹 在“空间预览轨迹”弹窗中核对轨迹是否与实际采图轨迹相符。 如果您对轨迹不满意，则需要重新采集数据并上传数据进行预处理。 单击“提交生产”进行地图注册。 注册完成后，“地图注册”列显示“注册成功”。

操作步骤 登录KooMap服务控制台，进入控制台页面。 在左侧导航栏，选择“AR地图”下的“项目管理”菜单，进入“项目管理”页面。 在“项目管理”页面，单击“新增项目”。 在“新增项目”弹窗中，参考表1填写项目相关信息。 表1 新增项目 配置项 配置说明 项目名称 必填项。 输入项目名称。 名称不可重复。 行政区域 必选项。 选择项目覆盖的行政区域。 项目描述 选填项。 根据界面提示输入有关项目描述信息。 单击“确定”，完成新增项目的创建。 新建的项目将显示在项目列表最前端。

KooMap服务与其他服务的关系 使用KooMap卫星影像生产服务需要配套OBS服务，KooMap系统从OBS加载原始影像文件或矢量数据，再进行影像处理。 使用KooMap实景三维生产服务需要配套OBS服务，KooMap系统从OBS加载倾斜摄影影像，再进行影像建模。 使用KooMap AR地图运行服务基础版，建议您先购买AR地图生产服务或咨询人工客服购买AR地图数据采集服务和AR地图数据构建服务，对业务指定的区域进行AR地图采集和生产并部署上云后，再通过API和SDK访问AR地图运行服务。 父主题： 其他问题

官方镜像工具 编译工具 使用版本 是否默认 jdk 8u372 - 11.0.18 是 17.0.2 - nodejs 18.18.2 是 20.10.0 - go 1.18.7 是 1.20.7 - python 3.8.18 是 3.12.1 - maven 3.8.8 是 内置工具 说明 git 2.27.0 jq 1.6 gcc 7.3.0 cmake 3.16.5 lz4 1.9.2 make 4.3 zip 3.0 unzip 6.0 curl 7.71.1 openssh 8.2 haveged 1.9.13 bzip2-devel 1.0.8 zlib 1.2.11 zlib-devel 1.2.11 父主题： 扩展插件

后续操作 查看代理列表 在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。 代理列表可显示代理机状态、内存使用率、可用硬盘等信息。 代理机有以下五种状态： 表5 代理机状态说明 代理机状态 说明 运行中 代理机正在执行任务。 空闲中 代理机处于连接状态，未运行任务。 停用 代理机处于连接状态，但被停用无法执行任务。 下线 代理机处于掉线断开状态，如需上线请登录代理机重新注册，否则删除即可。 删除中 代理机正在被删除中。 删除代理 在“代理列表”页面，单击操作列，可以删除指定的代理机。 “运行中”状态的代理机无法删除。 启动/停用代理 在“代理列表”页面，单击操作列，可停用对应代理，停用后，状态列显示为“停用”；单击，可以重新启用代理，状态列恢复为“空闲中”。 查看资源池详情 在“代理列表”页面，单击“资源池详情”页签，可以查看资源池的详细信息（资源池所有者、资源池类型、资源池创建时间以及描述信息）。

新建代理 完成新建资源池后，在资源池列表中找到目标资源池，单击资源池名称，进入“代理列表”页面。 单击“新建代理”，页面弹出对话框。 根据需要完成参数配置。 配置主机所需的网络环境。 表3 步骤一配置 配置项 配置说明 自动安装JDK 主机需要具备JAVA8+环境。 开启此开关后，将为主机自动安装JDK至“/usr/local”目录中。 如果关闭此开关，则需手动安装。如何安装JAVA8+？ 说明： 仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。 自动安装Git 主机需要具备Git环境。 开启此开关后，将为主机自动安装Git。 如果关闭此开关，则需手动安装。如何安装Git？ 说明： 仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。 自动安装Docker 主机需要具备Docker环境。 开启此开关后，将为主机自动安装Docker至“/usr/bin”目录中。安装完成后将自动注册服务并启动docker服务。 如果关闭此开关，则需手动安装。如何安装Docker？ 说明： 仅资源池类型为“LINUX”或“LINUX_DOCKER”时显示此配置项。 配置身份认证信息。 表4 步骤二配置 配置项 配置说明 AK Access Key Id。 在通过获取AK/SK下载的访问密钥文件中获取。 SK Secret Access Key。 在通过获取AK/SK下载的访问密钥文件中获取。 代理名称 代理（Agent）的名称，同一台主机不可以安装相同名称的代理。 请根据实际情况填写。为了方便管理，命名建议清晰，建议关联代理机IP，如：10.10.10.10-agent-01。 代理工作空间 代理在主机上运行的工作目录，任务执行的工作空间，同一台主机的不同代理不可以使用同样的代理工作空间。 请根据实际情况填写。为了方便管理，建议关联数据盘，例如： Linux：/opt/cloud/agent01。 Windows：C:/opt/cloud/agent01。 MAC：/opt/cloud/agent01。 生成命令。 完成参数配置，勾选“我已阅读并同意”，单击“生成命令”，命令框中自动生成安装代理命令。 单击“复制命令”，复制此命令。 登录主机，执行上一步复制的安装命令。 Linux主机：使用root账号登录主机，执行安装命令。 Windows主机：使用管理员身份登录主机，打开Git Bash，执行安装命令。 MAC主机：使用root账号登录主机，执行安装命令。 当命令终端显示如下提示时，表示安装结束。 图1 安装成功回显 返回“代理列表”页面，关闭弹窗。 等待10-30秒，刷新页面，在列表中可查看到已经安装的代理实例状态为“空闲中”，表示安装成功。

inputs介绍 inputs示例及参数介绍如下： { "name": "samplestring", # 如插件业务脚本中使用${samplestring}获取运行者在流水线上配置的值 "type": "input", # 不同类型信息对应不同展示功能，可选项见下文 "description": "Sample String", # input条目的描述信息，用于描述其值含义 "defaultValue": "00", # 默认值，required属性为false时，如不在流水线上重新输入，则默认使用此值 "required": true, # true则流水线编辑时必须重新填值，false则不填使用默认值 "label": "测试输入框", # input条目在流水线编辑页面显示的名称信息 "validation": { "requiredMessage": "请输入值", # (可选) 如required字段为true，未填写时的提示信息 "regex": "^[a-zA-Z0-9-_\\u4e00-\\u9fa5]{1,32}$", # (可选)可填写正则校验的内容 "regexMessage": "类型错误" # (可选) 如正则校验失败的提示信息 } } 当前支持的全量inputs定义请参见全量inputs。

插件包结构 文件结构： extension.zip # 插件zip包 | -- scripts # （可选）脚本文件夹，用于存放包含插件执行逻辑的脚本 | | -- xxx # 包含插件执行逻辑的脚本 | -- i18n # （可选）多语言，存放所有文案信息 | | -- zh-cn # 中文环境内容 | | -- resources.json # 对应语言的国际化资源 | | -- en-us # 英文环境内容 | | -- resources.json # 对应语言的国际化资源 | -- codeArts-extension.json # （必选）插件执行定义文件，Json格式，包括扩展插件的基本信息+input+execution 注意事项：

codearts-extension.json文件定义 “codearts-extension.json”文件示例内容如下： { "type": "Task", "name": "demo_plugin", "friendlyName": "示例插件", "description": "这是一个示例插件", "category": "Gate", "version": "0.0.2", "versionDescription": "0.0.1初始化版本", "dataSourceBindings": [], "inputs": [{ "label": "服务调用地址", "name": "SERVICE_URL", "type": "input", "description": "请输入服务地址url", "defaultValue": "", "required": true }, { "label": "调用服务的token", "name": "SERVICE_TOKEN", "type": "input", "description": "请输入调用服务的token", "defaultValue": "", "required": true }], "execution": { "type": "Shell", "target": "scripts/execution.sh" }, "outputs": [] } 参数说明如下： 参数项 说明 type 填写固定值“Task”，标识为一个插件类型。 name 请与注册插件时页面填写的基本信息“唯一标识”字段一致。 friendlyName 请与注册插件时页面填写的基本信息“插件名称”字段一致。 category 请与注册插件时页面填写的基本信息“插件类型”字段一致，包括以下可选值： Build：对应“构建”插件类型。 Test：对应“测试”插件类型。 Gate：对应“代码检查”插件类型。 Normal：对应“通用”插件类型。 Deploy：对应“部署”插件类型。 version 插件版本，支持填写3组0-99的数字，如需新增正式版本，请修改此字段。 description 插件的描述信息。 versionDescription 此版本插件的描述信息，建议体现每个版本的差异点。 dataSourceBindings 此字段暂时未启用，请将值设置为“[]”。 inputs 插件输入内容，对应流水线页面插件展示格式，其值可在业务脚本中通过引用环境变量的方式引用。 execution 业务插件执行内容，其中type字段为业务脚本语言类型，target字段为执行文件入口，建议放在scripts文件夹下。 outputs 插件输出内容，在插件运行结束后写入此处定义值，可对应用作门禁指标metrics，不同的展示结果output。

KooMap服务采用哪种计费模式，如何计费 计费模式：KooMap支持按需计费和套餐包两种计费模式。按需计费根据用户实际使用量和使用时长计费。这种计费方式比较灵活，可以按需开通和释放资源。套餐包是一种先付费再使用的计费模式，适用于对产品需求稳定且希望降低成本的用户。 计费规则： 卫星影像生产服务总费用 = 时空专属存储费用 + 各个基础处理服务费用 AR地图运行服务基础版总费用 = 时空专属存储费用 （公测时间不收取费用）+ 视觉定位和AR导航调用费用 实景三维生产服务总费用 = 时空专属存储费用 + 实景三维生产服务费用（基础版或专业版） AR地图生产服务总费用 = 时空专属存储费用（公测时间不收取费用） + AR地图生产服务费用 父主题： 计费FAQ

响应示例 { "job_id": "ff808082739334d80173943ec9b42130", "order_id": "CS2007281506xxxxx", "serverIds": [ "fe0528f0-5b1c-4c8c-9adf-e5d5047b8c17", "679854ae-a50d-40c9-8132-b19bf3a306a1" ] } 或 { "error": { "code": "Ecs.0005", "message": "request body is illegal." } }

请求示例 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的弹性公网IP，采用密码方式登录鉴权请求中的密码，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "adminPass": "$ADMIN_PASS", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "", "count": 1, "metadata": {}, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的按需按流量计费的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER", "chargemode": "traffic" }, "extendparam": { "chargingMode": "postPaid" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定共享带宽的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "id": "a0d4b26f-699d-49a0-bcc8-6f707a925abf", "sharetype": "WHOLE" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166", "agency_name": "test" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } }

接口约束 创建包年/包月云服务器时，支持自动支付和手动支付。 如果将请求中的isAutoPay字段设置为true，表示采用自动支付方式，系统会自动匹配账户支持的付款方式进行扣费。 自动支付支持的付款方式和顺序如下： 折扣优惠（每次只能使用一项）→代金券（每次只能使用一张）→现金券或储值卡（每次可使用多张，可同时使用）→账户余额（先扣现金额度后扣信用额度）或月末结算 如果上述付款方式无法完成支付，系统会自动生成一个待支付订单，您可以手动在控制台上选择支付方式进行支付。 自动支付的更多内容请参见自动支付。 如果将请求中的isAutoPay字段设置为false，表示采用手动支付方式，系统会自动生成一个待支付订单，您可以手动在控制台上选择支付方式进行支付。 创建按需计费云服务器时，系统会自动匹配适用的代金券进行使用。 如果您需要退订该包年/包月资源，请参考“退订包年/包月资源”。

响应消息 表7 响应参数 参数 参数类型 描述 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考查询Job状态。 order_id String 订单号，创建包年包月的弹性云服务器时返回该参数。 说明： 创建包年/包月云服务器资源后，请参考“支付包年/包月产品订单”进行支付。 如果需要查询订单的资源开通详情，请参考“查询订单详情”。 如果需要退订该包年/包月资源，请参考“退订包年/包月资源”。 serverIds Array of strings 云服务器ID列表。 说明： 通过云服务器ID查询云服务器详情 ，若返回404 可能云服务器还在创建或者已经创建失败。 异常响应请参考响应（任务类），异常响应要素说明。

功能介绍 创建一台或多台云服务器。 V1.1版本创建云服务器的接口兼容了V1版本创建云服务器（按需）的功能，同时合入新功能，支持创建包年/包月的弹性云服务器。 本接口为异步接口，当前创建云服务器请求下发成功后会返回job_id，此时创建云服务器并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUC CES S 时代表云服务器创建成功。 本接口支持在HTTP请求消息头中设置X-Client-Token请求头，保证请求幂等性。详细信息请参考请求幂等性说明。 弹性云服务器的登录鉴权方式包括两种：密钥对、密码。为安全起见，推荐使用密钥对方式。 密钥对 指使用密钥对作为弹性云服务器的鉴权方式。 接口调用方法：使用key_name字段，指定弹性云服务器登录时使用的密钥文件，key_name字段的使用方法请参见表2。 密码 指使用设置初始密码方式作为弹性云服务器的鉴权方式，此时，您可以通过用户名密码方式登录弹性云服务器，Linux操作系统时为root用户的初始密码，Windows操作系统时为Administrator用户的初始密码。 接口调用方法：使用adminPass字段，指定管理员账号的初始登录密码，adminPass字段的使用方法请参见表2。对于镜像已安装Cloud-init的Linux云服务器，如果需要使用密文密码，可以使用user_data字段进行密码注入，具体请参见表2。 对于安装Cloud-init镜像的Linux云服务器，若指定user_data字段，则adminPass字段无效。