文件上传 #

支持的文件格式 #

逸云支持多种地理数据格式：

GeoJSON #

最流行的矢量数据交换格式。

基本要求 #

• 坐标系统：WGS84 (EPSG:4326)
• 坐标顺序：[经度, 纬度]
• 编码格式：UTF-8

示例结构 #

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [116.4074, 39.9042]
    },
    "properties": {
      "name": "天安门"
    }
  }]
}

几何类型 #

• Point：点
• LineString：线
• Polygon：面
• MultiPoint：多点
• MultiLineString：多线
• MultiPolygon：多面

COG (Cloud Optimized GeoTIFF) #

针对云存储优化的 GeoTIFF 格式。

优势 #

• 支持分块读取，无需下载整个文件
• 内置多分辨率金字塔
• 适合大文件在线浏览

生成 COG #

使用 GDAL 命令行工具：

# 转换为 COG
gdal_translate input.tif output.tif \
  -co TILED=YES \
  -co COPY_SRC_OVERVIEWS=YES \
  -co COMPRESS=DEFLATE

# 生成金字塔
gdaladdo -r average output.tif 2 4 8 16

3D Tiles #

大规模三维数据格式。

支持的数据源 #

• 城市三维模型
• 倾斜摄影测量
• BIM 建筑模型

文件结构 #

3D Tiles 是一个目录，包含：

• tileset.json：主描述文件
• .b3dm：批量3D模型数据
• .pnts：点云数据

DXF #

AutoCAD 标准文件格式。

支持的内容 #

• 图层结构
• 几何图形（线、多段线、圆等）
• 块引用
• 属性文字

注意事项 #

• 建议先进行地理配准
• 复杂块引用可能显示不完整
• 文字样式使用系统默认字体

COG坐标系自动转换 #

上传非标准坐标系的COG文件时，系统会自动：

1. 检测文件坐标系
2. 如非EPSG:3857，自动转换整个文件
3. 替换为转换后的文件
4. 显示转换状态提示

上传步骤 #

1. 打开上传面板 #

• 点击侧边栏的"上传"标签

2. 选择文件类型 #

• 在"文件类型"下拉框中选择：
  • GeoJSON (矢量)：用于点、线、面数据
  • COG (栅格)：用于影像、高程数据
  • DXF (CAD)：用于CAD图纸

3. 选择项目 #

• 选择要上传到的目标项目
• 文件将与该项目关联

4. 选择文件 #

• 点击"选择文件"按钮
• 浏览并选择要上传的文件
• 确保文件格式和大小符合要求

5. 添加描述（可选） #

• 在"描述"文本框中输入文件说明
• 便于后续识别和管理

6. 上传文件 #

• 点击"上传文件"按钮
• 等待上传完成
• 上传成功后，系统会自动加载图层到地图

上传限制 #

文件大小 #

COG转换时间参考 #

• ✅ < 100MB：快速转换
• ⚠️ 100-500MB：中等耗时
• ❌ > 500MB：较慢（建议预转换后上传）

数量限制 #

• 单个项目最多 100 个文件
• 总存储空间取决于部署配置

常见问题 #

Q: 上传失败怎么办？ #

检查：

1. 文件格式是否正确（.geojson, .json, .tif, .tiff, .dxf）
2. 文件大小是否超过限制（GeoJSON/DXF 50MB, COG 500MB）
3. GeoJSON格式是否规范，可用在线工具验证
4. 网络连接是否正常
5. 是否选择了正确的目标项目

Q: 文件上传成功但无法加载？ #

可能原因：

1. 坐标系统不正确
2. 文件数据损坏
3. 几何类型不支持
4. 不属于当前项目

解决方法：

• 使用专业工具（如QGIS）检查数据
• 确保坐标系正确
• 重新生成文件并上传
• 切换到正确的项目

Q: COG文件坐标系问题？ #

• 系统会自动检测并转换非标准坐标系
• 转换成功后会显示提示
• 如转换失败，可手动使用GDAL转换后重新上传
• 详见 docs/COG_CONVERSION_GUIDE.md

最佳实践 #

• 上传前检查数据质量
• 大数据集分区域上传
• 使用 COG 格式存储栅格数据
• 定期清理不需要的文件