GIS数据转换

接口调用大致流程：上传文件 => 查询转换状态 => 转换完成下载文件
例：
dwg 转 geojson: 6 => 2 => 4
dwg 转 shp: 6 => 2 => 5
geojson 转 dwg: 1 => 7 => 2 => 3
shp 转 dwg: 1 => 8 => 2 => 3

1 初始化 dwg 图纸

简要描述

• json、geojson 或者 shp 转换成 dwg 时，转换操作需要指定图纸，当前接口会创建空白图纸，并返回图纸的文档 ID

请求 URL

• /api/jsonToEntity/initDwg

请求方式

• GET

参数 无

返回示例*

  {
    "code": 0,
    "msg": "操作成功",
    "data": {
      "docId": "123596989658965",
      "name": "123596989658965.dwg"
    }
  }

返回参数说明

参数名	类型	说明
docId	long	文档 ID，图纸唯一标识，用于发起转 dwg 请求、查询转换状态和下载 dwg 文件等接口
name	string	图纸名

备注

2 查询转换状态

简要描述

• 发起转化请求后，用来查询是否转换完成

请求 URL

• /api/jsonToEntity/transferStatus

请求方式

• GET

参数

参数名	必选	类型	说明
docId	是	string	文档 ID

返回示例*

  {
	"code": 0,
	"msg": "操作成功",
	"data": {
		"transferStatus": 2,
		"jsonStatus": 2,
		"type": 2
	}
}

返回参数说明

参数名	类型	说明
code	int	状态码
msg	string	消息
data	object	响应体
transferStatus	int	dwg 转换状态，0：待转换，1：转换中，2：转换成功，3：转换失败（json、geojson 或者 shp 转 dwg）
jsonStatus	int	json、geojson 或者 shp 的转换状态，0：待转换，1：转换中，2：转换成功，3：转换失败 （dwg 转 json、geojson 或者 shp）
type	int	转换类型（只针对 jsonStatus 生效），1：dwg 转 json，2：dwg 转 geojson，3：dwg 转 shp

备注

3 下载 DWG 文件

简要描述

• 下载图纸，和查询转换状态接口配合，等待转换完成后调用此接口下载图纸，支持下载 json、geojson 和 shp 转换的 dwg。

请求 URL

• /api/jsonToEntity/downloadDwg

请求方式

• GET

参数

参数名	必选	类型	说明
docId	是	long	文档 ID

返回参数说明

返回图纸文件二进制流

备注

4 下载 geojson 文件

简要描述

• 下载转换完成的 json 或者 geojson 文件，和查询转换状态接口配合，等待 dwg 图纸转换完成后调用此接口下载 json 或者 geojson 文件。

请求 URL

• /api/jsonToEntity/downloadJson

请求方式

• GET

参数

参数名	必选	类型	说明
docId	是	long	文档 ID

返回参数说明

返回 Json 文件二进制流

备注

5 下载 shp 文件

简要描述

• 下载转换完成的图纸，和查询转换状态接口配合，等待 dwg 图纸转换完成后调用此接口下载 shp 文件压缩包。

请求 URL

• /api/jsonToEntity/downloadShp

请求方式

• GET

参数

参数名	必选	类型	说明
docId	是	long	文档 ID

返回参数说明

返回 shp 文件压缩包二进制流

备注

6 上传 dwg 图纸（异步）

简要描述

• 该接口用于上传 Dwg 图纸，图纸上传完成后立即返回结果。后台内部异步进行 dwg 转 json、geojson 或者 shp 的处理，上传完成后，需要搭配查询转换状态接口判断是否转换完成。

请求 URL

• /api/jsonToEntity/uploadDwg

请求方式

• Body Form-Data

参数

参数名	必选	类型	说明
file	是	文件二进制流	dwg 图纸文件
transferType	否	Integer	1:表示转成 json；2：表示转成 geojson；3:表示转成 shp

返回示例*

  {
    "code": 0,
    "msg": "操作成功",
    "data": {
		"docId": "12345678948"
	}
  }

返回参数说明

参数名	类型	说明
code	int	状态码，0：表示成功，其他失败
msg	string	消息
data	object	响应数据
docId	string	图纸的唯一标识，用于查询转换状态和下载文件

备注

7 上传 geojson（异步）

简要描述

• 该接口用于上传 geojson，上传完成后立即返回结果。后台内部异步进行转 dwg 的处理，上传完成后，需要搭配查询转换状态接口判断是否转换完成。

请求 URL

• /api/jsonToEntity/uploadJson

请求方式

• Body Form-Data

参数

参数名	必选	类型	说明
file	是	文件二进制流	geojson 文件
docId	否	string	dwg 图纸的文档 ID

返回示例*

  {
    "code": 0,
    "msg": "操作成功",
    "data": {
		"docId": "12345678948"
	}
  }

返回参数说明

参数名	类型	说明
code	int	状态码，0：表示成功，其他失败
msg	string	消息
data	object	响应数据
docId	string	图纸的唯一标识，用于查询转换状态和下载文件

备注

8 上传 shp 文件（异步）

简要描述

• 该接口用于上传 shp，上传完成后立即返回结果。后台内部异步进行转 dwg 的处理，上传完成后，需要搭配查询转换状态接口判断是否转换完成。

请求 URL

• /api/jsonToEntity/uploadShp

请求方式

• Body Form-Data

参数

参数名	必选	类型	说明
files	是	文件二进制流	shp 文件列表
docId	否	string	dwg 图纸的文档 ID

返回示例*

  {
    "code": 0,
    "msg": "操作成功",
    "data": {
		"docId": "12345678948"
	}
  }

返回参数说明

参数名	类型	说明
code	int	状态码，0：表示成功，其他失败
msg	string	消息
data	object	响应数据
docId	string	图纸的唯一标识，用于查询转换状态和下载文件

备注