重建算法说明

• 重建算法参数是填写在 POST /v2/jobs/<job-uuid>/start 接口的 parameters 字段里的，需要先把 json 对象序列化为字符串。
• 2D、3D、LiDAR 重建作业的配置填在 parameter 字段里。
• 跟 parameter 参数平级的 predefine_AOI 参数是一个可选参数，且只有在 2D 和 3D 作业里才生效。
• 跟 parameter 参数平级的 export_parameter 参数是一个可选参数，设置重建成果导出的目录结构和内容。
• type 的值根据作业类型而定，2D、3D、LiDAR 重建作业的 type 分别是 14、15、13。

{"resourceUuid": "{your resource uuid}", "parameters": "{\"parameter\": {}, \"predefine_AOI\": {}, \"export_parameter\": {}}", "type": number}

公共部分

空三和点云成果参数

参数类别	参数项	值类型	默认值	是否可选	说明
空三处理参数	SfM_method	enum_string	GLOBAL	可选	空三算法，可选值 "GLOBAL"、"INCREMENTAL"。 如果大部分图片都是带 RTK 精确位置的图片，建议选择 "GLOBAL"。如果是没有 GPS 的图片，建议选择 "INCREMENTAL"。
	sfm_feature_quantity_level	enum_int	2	可选	特征点数量上限，可选值为 1、2、3，分别代表：4w、2w、9k
	use_image_position	bool	true	可选	是否使用影像记录的位置信息
空三成果参数	generate_blocks_exchange_xml	bool	false	可选	是否生成 CC 格式的空三成果：BlocksExchange.xml
	blocks_exchange_xml_geo_desc	struct	{}	可选	CC 格式的空三成果的输出坐标系，格式 geo-desc-object 如果是没有 GPS 的图片进行重建，该项不能设置为地理坐标系，用默认值即可
点云成果参数	output_pointcloud	bool	false	可选	是否输出点云成果 默认 false 该选项置为 true 后，点云成果参数才生效
	generate_pnts	bool	true	可选	是否生成 pnts 格式的点云 LOD 模型，可用 Terra 软件 或者 Cesium 网页查看
	generate_las	bool	false	可选	是否生成 LAS 格式点云模型
	generate_point_s3mb	bool	false	可选	是否生成 s3mb 格式点云模型，可用超图软件查看
	generate_point_ply	bool	false	可选	是否生成 ply 格式点云模型
	generate_pcd	bool	false	可选	是否生成 pcd 格式点云模型
	merge_point	bool	false	可选	是否将点云合并成一个文件
兴趣区域范围	max_altitude	float		必填	最大高度（米）
	min_altitude	float		必填	最小高度（米）
	polygon_points	three-dimensional floating array		必填	多边形点集，描述兴趣区域在水平方向的轮廓，形式如 `[[22.62832081, 113.9337651, 32.14], [22.6292795, 113.9333697, 33.585], [22.62957106, 113.9358513, 33.923]]`
	geo_desc	struct		必填	polygon_points 所在的坐标系表述，格式见 "地理坐标系" 章节里的 "WKT 描述的地理坐标系" 或 "EPSG 代号描述的地理坐标系" 部分
成果导出参数	pc_dir_structure	bool	false	必填	是否使云端重建的结果输出目录与本地的 Terra 软件的重建结果输出目录保持一致；使导出文件能导入到 Terra 软件中；
	undistort_images	bool	false	可选	是否导出重建过程中的去畸变照片； Lidar 任务不支持此参数
	temp_result_files	bool	false	可选	是否导出重建过程中的中间结果文件，中间结果文件会占用较大的存储空间；

地理坐标系

2D/3D/LiDAR 三种作业的 output_geo_desc 字段，可以配置为如下四种坐标系类型的其中一种。

WKT 描述的地理坐标系

参数项	值类型	默认值	是否可选	说明
cs_type	enum_string	GEO_CS	可选	地理坐标系，可选值为 "GEO_CS"、"LOCAL_CS"、"LOCAL_ENU_CS"
geo_cs_wkt	string		可选	坐标系描述，参见 Well-Known-Text格式
offset	array	[0.0, 0.0, 0.0]	可选	坐标偏移量，在当前坐标系下，对成果坐标再进行整体偏移

EPSG 代号描述的地理坐标系

参数项	值类型	默认值	是否可选	说明
cs_type	enum_string	GEO_CS	可选	地理坐标系，可选值为 "GEO_CS", "LOCAL_CS", "LOCAL_ENU_CS"
geo_cs	string	""	可选	地理坐标系，参见EPSG:4326格式
override_vertical_cs	string	""	可选	重载高程坐标系，默认为空，格式 "EPSG:4326"（和 geo_cs 绑定）。
offset	array	[0.0, 0.0, 0.0]	可选	坐标偏移量，在当前坐标系下，对成果坐标再进行整体偏移

局部坐标系

参数项	值类型	默认值	是否可选	说明
cs_type	enum_string	LOCAL_CS	可选	地理坐标系，可选值为 "GEO_CS", "LOCAL_CS", "LOCAL_ENU_CS"
offset	array	[0.0, 0.0, 0.0]	可选	坐标偏移量，在当前坐标系下，对成果坐标再进行整体偏移

ENU 坐标系

参数项	值类型	默认值	是否可选	说明
cs_type	enum_string	LOCAL_ENU_CS	可选	地理坐标系，可选值为 "GEO_CS"、"LOCAL_CS"、"LOCAL_ENU_CS"
offset	array	[0.0, 0.0, 0.0]	可选	坐标偏移量，在当前坐标系下，对成果坐标再进行整体偏移
ref_GPS	struct	{}	可选	参考的原点 GPS 坐标，如 {"altitude": 23.0, "latitude": 28.0, "longitude": 113.0 }

2D 重建算法参数

参数类别	参数项	值类型	默认值	是否可选	说明
空三处理参数	见 “公共部分“ 的 “空三处理参数”
空三成果参数	见 "公共部分" 的 “空三成果参数”
二维重建参数	map_mode	enum_int		必选	拼图模式，可选值为 0、1、2，分别代表农田模式，城市模式，果树模式
	quality_level	enum_int	1	可选	可选值 1、2、3，分别代表重建的精细程度：高精度、中精度、低精度
	use_Wallis	bool	false	可选	是否开启图像内部匀色，单张图片中明暗不一致时建议开启，可能会损失对比度，谨慎使用
	use_Dehaze	bool	false	可选	是否开启去雾，采集的图片中存在云雾时建议开启
	use_gcj02	bool	false	可选	是否使用国测局坐标系，仅对地图瓦片生效
	dom_tile_size	int	0	可选	>0 时输出分块成果，表示单块 DOM 像素尺寸，该参数必须为 2 的整数倍
	output_geo_desc	struct	{}	可选	输出坐标系描述，格式请见 “地理坐标系” 表格，默认 {} 表示没有指定输出坐标系，将由算法自动确定
兴趣区域范围	predefine_AOI	struct	{}	可选	见 "公共部分" 的 “兴趣区域范围”
成果导出参数	export_parameter	bool	false	可选	见 "公共部分" 的 “成果导出参数”

示例

生成城市场景的二维正射地图

{
  "parameter": {
    "map_mode": 1,
    "quality_level": 1,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32650",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

分幅输出城市场景的二维正射地图，重建产物需要导入到 Terra 软件，不导出中间成果文件和重建照片

{
  "export_parameter": {
    "pc_dir_structure": true,
    "undistort_images": false,
    "temp_result_files": false
  },
  "parameter": {
    "map_mode": 1,
    "quality_level": 1,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32650",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    },
    "dom_tile_size": 5000
  }
}

3D 重建算法参数

参数类别	参数项	值类型	默认值	是否可选	说明
空三处理参数	见 “公共部分” 的 “空三处理参数”
空三成果参数	见 “公共部分” 的 “空三成果参数”
点云成果参数	见 “公共部分” 的 “点云成果参数”
纹理模型成果参数	output_mesh	bool	true	可选	是否生成网格 该选项置为 true 后，纹理模型成果参数才生效
	generate_ply	bool	true	可选	是否生成 ply 格式的纹理模型
	generate_obj	bool	false	可选	是否生成 obj 格式的纹理模型
	generate_b3dm	bool	true	可选	是否生成 b3dm 格式的网格 LOD (细节层次) 模型，可用 Terra 软件 或者 Cesium 网页查看
	generate_osgb	bool	false	可选	是否生成 osgb 格式的网格 LOD 模型
	generate_s3mb	bool	false	可选	是否生成 s3mb 格式的网格 LOD 模型，可用超图软件查看
	generate_i3s	bool	false	可选	是否生成 i3s 格式的网格 LOD 模型，可用 ArcGIS 软件查看
	water_refine	bool	false	可选	是否开启水面平整，测区中有较大水域需要重建时建议开启
	model_simplify	float	1.0	可选	简化模型面片数量至指定比例（如 0.2 对应 20%），需要将 LOD 模型用于网页轻量化浏览时建议设置为小于1的数值。范围是 [0.05-1]，1 表示不简化
点云和纹理模型共用参数	cut_AOI	bool	false	可选	是否删去拍摄位置之外的部分，环绕拍摄采集的数据建议开启
	quality_level	enum_int	2	可选	重建的精细程度，可选值 1、2、3，分别代表：高精度、中精度、低精度
	output_geo_desc	struct	{}	可选	输出坐标系描述，格式为 geo-desc-object，默认 null 表示没有指定输出坐标系，将由算法自动确定
兴趣区域范围	predefine_AOI	struct	{}	可选	见 "公共部分" 的 “兴趣区域范围”
成果导出参数	export_parameter	bool	false	可选	见 "公共部分" 的 “成果导出参数”

示例

生成普通三维模型

{
  "parameter": {
    "output_mesh": true,
    "generate_obj": true,
    "generate_b3dm": true,
    "generate_osgb": true
  }
}

生成需要修模的三维模型，重建产物需要导入到 Terra 软件，并导出重建照片

{
  "export_parameter": {
    "pc_dir_structure": true,
    "undistort_images": true,
    "temp_result_files": false
  },
  "parameter": {
    "generate_blocks_exchange_xml": true,
    "output_mesh": true,
    "generate_obj": true,
    "generate_b3dm": true,
    "generate_osgb": true,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

环绕拍摄的图片重建三维模型

{
  "parameter": {
    "cut_AOI": true,
    "output_mesh": true,
    "generate_obj": true,
    "generate_b3dm": true,
    "generate_osgb": true,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

生成电力线三维点云模型

{
  "parameter": {
    "output_pointcloud": true,
    "generate_pnts": true,
    "generate_las": true,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

LiDAR 重建算法参数

参数类别	参数项	值类型	默认值	是否可选	说明
通用处理参数	colorize_point	bool	true	可选	是否对激光雷达点云进行着色
	lpp_optimise	bool	false	可选	是否对激光雷达点云进行 ICP (迭代最近点算法) 优化
	refine_calibrate	int	0	可选	是否进行自标定（0 为否, 1 为是）
	lidar_point_max_distance	int	300	可选	激光雷达点云的最大有效距离，超过该距离的点云将被裁剪掉
	smooth_point	bool	false	可选	是否对激光雷达点云进行平滑
	sample_distance	float	0	可选	对激光雷达点云进行体素降采样的采样距离。默认 0 表示不降采样 如果只想按照体素降采样，则需要将 quality_level 设为 1
	output_height_offset	float	0	可选	高度偏移值，对输出成果进行高度上的偏移
	quality_level	enum_int	2	可选	按时序对点云进行降采样的采样率，可选值 1、2、3，分别代表 100%、25%、6.25% 与 sample_distance 的设置有冲突，通常 按体素降采样和按照时序降采样只选一种
	output_geo_desc	struct	{}	可选	输出坐标系描述，默认 {} 表示没有指定输出坐标系，将由算法自动确定
点云成果参数	见 “公共部分” 的 “点云成果参数”
地面点提取参数	ground_extract	bool	false	可选	是否提取地面点
	scene_type	enum_int	1	可选	地面场景类型，可选值 0、1、2，分别代表平地、缓坡、陡坡
	max_size_building	float	20	可选	场景中最大建筑物的对角线长度。范围 [1, 1000]
	iter_dist	float	默认值跟随场景类型变化	可选	迭代距离，scene_type 有平地、缓坡、陡坡。默认值分别为 0.3、0.5、0.7。范围 [0.01, 10]
	iter_angle	float	默认值跟随场景类型变化	可选	迭代角度，scene_type 有平地、缓坡、陡坡。默认值分别为 3、6、10。范围[0.01, 60]
DEM成果参数	generate_dem	bool	false	可选	是否生产DEM
	dem_resolution	float	2.0	可选	DEM 的分辨率（单位米）。默认 2.0，范围 [0.05, 50]
成果导出参数	export_parameter	bool	false	可选	见 "公共部分" 的 “成果导出参数”

示例

生成 DEM

{
  "parameter": {
    "output_pointcloud": true,
    "generate_las": true,
    "generate_dem": true,
    "dem_resolution": 2.0,
    "ground_extract": true,
    "scene_type": 1,
    "max_size_building": 20,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

精度优化后生成三维点云模型，重建产物需要导入到 Terra 软件，并导出重建的中间成果文件

{
  "export_parameter": {
    "pc_dir_structure": true,
    "undistort_images": false,
    "temp_result_files": true
  },
  "parameter": {
    "lpp_optimise": true,
    "output_pointcloud": true,
    "generate_pnts": true,
    "generate_las": true,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

生成体素降采样的三维点云模型

{
  "parameter": {
    "sample_distance": 0.2,
    "output_pointcloud": true,
    "generate_pnts": true,
    "generate_las": true,
    "output_geo_desc": {
      "cs_type": "GEO_CS",
      "geo_cs": "EPSG:32649",
      "geo_cs_wkt": "",
      "override_vertical_cs": ""
    }
  }
}

重建成果说明及质量报告

• TerraAPI 与大疆智图软件的输出成果一致，详细成果说明见大疆智图操作白皮书
• json 格式的重建质量报告分别位于
  • AT，AT/report/sfm_report.json
  • 2D，report/map_report.json
  • 3D，report/model_report.json
  • LiDAR，report/report.json