1. 上传GEO模型

上传Shapefile、遥感影像、3DTiles、glTF、GeoJSON、OSGB、topojson、kml、图标文件。


请求方式:POST

请求地址:/api/{databaseKey}/geomodels

1.1. 请求参数

Headers:

参数名 类型 示例 是否必填 参数含义
Authorization string c4570cb9ca324bc8ba7dd9d1967710ea 操作的通关令牌

PathParas:

参数名 类型 示例 是否必填 参数含义
databaseKey string test 数据库key,必传

SearchParas:

参数名 类型 示例 是否必填 参数含义
无参数 NULL NULL NULL NULL

Body

application/json:

from-data:
{
    "file": "文件对象", //必填
    "name": "xxx", //模型名称(不带扩展名),必填
    "type": "xxx", //模型类型,选填
    "xattr": //扩展属性  {
        "longitude": 0,
        "latitude": 0,
        "height": 0,
        "heading": 0,
        "pitch": 0,
        "roll": 0,
        "minLon": 0,
        "maxLon": 0,
        "minLat": 0,
        "maxLat": 0,
        "parseType": "xxx", //shp模型解析类型,选填
        "heightProperty": "xxx" //高度字段名,选填
    }
}

1.2. 参数说明

参数名 类型 示例 是否必填 参数含义
file 文件对象 NULL 文件对象
name string NULL 模型名称(不带扩展名)
type string NULL 模型类型
xattr string NULL 扩展属性
targetType string NULL shp模型解析类型
heightProperty string NULL 高度字段名
permission string NULL 权限

1.3. 正确返回

{
    "message": "请求处理成功",
    "code": "SUCCESS",
    "data": {
        "key": "GEO模型Key",
        "type": "GEO模型类型",
        "status": "模型当前解析状态",
        "remark": "解析状态说明"
    }
}

1.4. 状态码

状态码 code message data 原因
400 BAD_PARAMETER 无法确定文件类型 NULL 当模型文件类型不能识别时
400 BAD_PARAMETER 参数type与文件实际类型不一致 NULL 当type参数不是SHP、RSI、3DTILES、GLTF、GEOJSON、OSGB、ICON、TOPOJSON、KML之一时

1.5. 备注

模型解析状态:

0:正解解析

1:解析成功

-1:解析失败

1.6. 注意事项

1、 GEO模型文件类型及格式:

​ Shapefile:SHP,.zip,其中包含.shp文件

​ 遥感影像:RSI,.jpg或.png

​ 3DTiles:3DTILES,.zip,其中包含tileset.json文件

​ glTF:GLTF,.gltf或.glb

​ GeoJSON:GEOJSON,.geojson

​ OSGB文件,osgb,zip格式

​ ICON:.png、.jpg、.jpeg、.bmp

​ TOPOJSON:.topojson

​ KML:.kml、.kmz

2、type可选,值为SHP、RSI、3DTILES、GLTF、GEOJSON、OSGB、ICON、TOPOJSON、KML之一,不区分大小写;type为空时,校验上传文件内容,确定模型类型。

3、3DTILES文件应指定模型位置参数:longitude、latitude,如不指定则采用上述默认值。

4、GLTF文件应指定模型方位参数:longitude、latitude、height、heading、pitch、roll,如不指定则采用上述默认值。

5、RSI文件应指定模型坐标范围参数:minLon、maxLon、minLat、maxLat,如不指定则采用上述默认值。

6、当type是shp时,targetType可以指定为GEOJSON或者3DTILES,选填。默认值时GEOJSON。

7、当shp模型指定的解析类型是3DTILES时,如果指定heightProperty参数或者模型中有默认的高度字段height(不分大小写),会直接解析。如果没有高度字段,会解析出错。

8、此时需要调用获取shp模型数据字段接口,获取字段信息。根据获取的字段信息,指定其中之一为高度字段,然后调用更新shp模型的解析接口重新解析。

9、当文件后缀为.png或.jpg时,如未指定type,则视为RSI文件。

10、 OSGB 格式倾斜摄影文件,无需设置扩展属性xattr

文件目录结构必须合法,数据目录必须有一个 “Data” 目录的总入口, “Data” 目录同级放置一个metadata.xml 文件用来记录模型的位置信息。

每个瓦片目录下,必须有个和目录名同名的 osgb 文件,否则无法识别根节点。

正确的目录结构如下:

--metadata.xml

--Data\Tile_000_000\Tile_000_000.osgb

版权所有@盈嘉互联(北京)科技有限公司 京ICP备15051988号-9 Copyright © 2021 all right reserved,powered by Gitbook该文件修订时间: 2021-08-25 16:16:24

results matching ""

    No results matching ""