GIS 文件导入

Aptli 可以导入多种标准 GIS 和 CAD 文件格式并将其转换为地图要素。导入以后台任务方式运行，您可以在大文件处理期间继续工作。导入的要素进入暂存区，您可以在那里按视口过滤、检查与现有数据的碰撞，并选择要提交到地图的要素。

支持的格式

所有转换均在服务器端处理。包含多个图层的文件将提取第一个（或默认）图层。

开始导入

通过数据传输面板：

1. 打开地图，点击数据传输按钮（版本控件旁边的 ↕ 图标）
2. 切换到导入选项卡
3. 点击选择文件并选择您的 GIS 文件
4. 点击上传 — 文件在开始处理前会进行恶意软件扫描

通过导入列表页（管理）：

1. 导航至管理 → 导入
2. 点击新建导入
3. 选择文件 → 上传

导入需要 featureCreate 管理员权限。

导入任务

上传是异步的。文件通过安全扫描后，立即创建导入任务并在后台开始处理。您会立即获得任务 ID，无需留在页面等待。

任务状态

检查状态

任务出现在导入面板中（数据传输 → 导入选项卡 → 最近导入）。列表自动刷新。您也可以离开页面后返回——任务保留 24 小时。

点击已完成的任务会打开要素预览，提取的要素显示在地图上。

要素数量上限

每个文件的导入上限为 5,000 个要素。如果文件包含更多要素：

• 导入前 5,000 个要素
• 任务上设置 truncated: true 标志
• 总要素数记录在 totalFeatures 中
• 导入面板中显示警告

对于超过 5,000 个要素的文件，请在上传前将源数据分割成较小的块，或联系管理员讨论批量处理选项。

审查导入的要素

任务完成后，要素尚未永久存入地图——它们作为草稿要素落入绘图暂存区。

空间过滤

提交前，您可以按以下方式过滤预览：

• 边界框 — 拖动地图到感兴趣的区域；预览自动更新
• 多边形过滤 — 绘制自定义多边形以选择导入的子区域

当大文件覆盖的区域超出您的需要时，这非常有用。

碰撞检测

Aptli 检查导入的要素与地图上已有的要素之间的碰撞。如果导入的要素在相同位置与相同名称的现有要素重叠，会出现碰撞警告：

• 重复候选 — 在阈值距离内名称和几何相同
• 几何冲突 — 同一图层中的重叠多边形

您可以：

• 接受导入（无论如何创建新要素）
• 跳过冲突要素
• 合并到现有要素

提交到地图

审查后：

1. 选择要保留的要素（或"全选"）
2. 从下拉列表中选择目标图层 — 导入的要素采用该图层的 schema
3. 点击提交到地图
4. 要素获得 _uncommitted 标志（在您的草稿中可见，尚未上传到服务器）
5. 准备好后使用版本控件（提交）推送到服务器

几何类型分割

如果源文件包含混合几何类型（例如，同时包含点和多边形的 GDB），Aptli 会为每种类型创建单独的草稿导入图层：

• _import_filename_point
• _import_filename_line
• _import_filename_polygon

每种类型可以独立提交到不同的目标图层。

故障排除

"转换失败"

服务器端转换失败。常见原因：

• 压缩文件不包含有效的 shapefile（缺少 .dbf 或 .prj）
• 文件损坏
• GDB 使用不受支持的 ESRI 格式版本

查看失败任务上的错误消息了解具体信息。尝试在本地用 QGIS 打开文件以验证其可读性。

"文件未通过安全扫描"

文件已被安全扫描器隔离。请勿重新上传相同文件。如果您认为是误报，请联系管理员。

"不支持的文件类型"

仅接受上表中列出的扩展名。请正确重命名文件（例如，ZIP 压缩包中的 SHP 文件必须以 .zip 结尾）。

导入在 24 小时后消失

导入任务在 24 小时后到期。在此时限内未提交到地图的已完成任务将被删除。请在任务到期前提交您选择的要素。

权限