超擎时空大数据服务平台接口文档 1.1 匹配 ... · 变量名描述类型备注 crsid 标识 string 匹配优先级：1 epsg EPSG ID string 匹配优先级：2 name

变量名描述类型备注

crsid 标识 string 匹配优先级：1

epsg EPSG ID string 匹配优先级：2

name 名称 string 匹配优先级：3


message string

result object

-- crsid string

-- name string

-- proj4 string

-- wkt string

status number

超擎时空大数据服务平台接口文档

阅前指导：

超擎时空大数据平台接口文档，主要包括13大类功能：系统管理、标签管理、数据源管理、数据集管理、工作空间管理、数据导入、符号库、地图、数据编辑、查询统计、渐进传输服务、WFS服务、国军标和数据导出。

1 系统管理

1.1 匹配坐标参考系

请求类型： get 请求URL：/ngse/v3/crs/match 接口描述：无请求参数列表：

响应参数列表：

1.2 获取坐标参考系列表

请求类型： get 请求URL：/ngse/v3/crs/project 接口描述：无请求参数列表：

af://n0

af://n2

af://n4

af://n5

af://n70


code code过滤 string 第1优先级

crsid crsid过滤，如EPSG:4326 string 第2优先级


message string

result

array

-- bound object

---- maxx number

---- maxy number

----minx number

---- miny number

-- code 同crsid string

-- crsid string

-- name string

-- proj4 string

-- ref_urn number

-- urn string

-- wkt string

status 错误码 number


1.3 获取系统参数

请求类型： get 请求URL：/ngse/v3/config 接口描述：无请求参数列表：

af://n170


空


message 错误信息 string

result object

-- map_style 样式参数 object

---- style_base_url 样式baseURL string

---- style_thumbnail_url 缩略图URL string

---- symbolic_library_url 符号库URL string

-- map_tile 切片参数 object

---- tile_base_url 瓦片文件baseURL string

-- user 用户参数 object

---- user_photo_url 头像URL string



空


空


1.4 资源代理

请求类型： get 请求URL：/proxy/ http address base code 接口描述：通过服务器代理获取URL资源，避免跨域问题。请求参数列表：


2 标签管理

2.1 创建标签

请求类型： post 请求URL：/ngse/v3/tag?token= 接口描述：同一个用户下标签名称不可重复。请求参数列表：

af://n245

af://n270

af://n271


name 名称 string


message 错误消息 string

result 结果信息 object

-- data_id 新增标签ID string



空




-- data_id ID string

-- delete_rows 删除的行数 number



name 名称，可修改 string


2.2 指定ID-删除

请求类型： delete 请求URL：/ngse/v3/tag/{id}?token= 接口描述：操作前提是没有任何数据集、数据源使用该标签，否则会删除失败。请求参数列表：


2.3 指定ID-编辑

请求类型： post 请求URL：/ngse/v3/tag/{id}?token= 接口描述：可编辑某些字段数据。请求参数列表：


af://n311

af://n356




-- data_id string

-- update_rows number



空



result object 无数据时返回空对象{}

-- data_create_time 创建时间 string

-- data_id ID number

-- data_update_time 更新日期 string

-- data_update_user 更新用户 number

-- data_version 版本号 number

-- name 名称 string

-- user_id 创建人id number



空

2.4 指定ID-获取详情

请求类型： get 请求URL：/ngse/v1/tag/{id}?token= 接口描述：获取标签记录的详细描述。请求参数列表：


2.5 查询标签列表

请求类型： get 请求URL：/ngse/v1/tag?token= 接口描述：查询所有已存在的标签请求参数列表：

af://n401

af://n471



result object

-- item 标签集合

array

-- data_create_time 创建时间 string

-- data_id 标签ID number



-- name 标签名称 string

-- user_id 创建用户 number



column_charset 属性名称编码utf-8/gbk string ------

content_charset 属性数据编码 string ------

datasource_id 数据源ID number ------

layer_id 图层文件标识 number ------

layer_name 图层名称 string ------


3 数据源管理

3.1 批量获取图层详情

请求类型： post 请求URL：/ngse/v3/datasource/layer 接口描述：获取源文件的指定数据集的详细描述。请求参数列表：


af://n541

af://n542


message 返回消息 string

result object

-- crs 坐标参考系 object

---- crsid string

---- name string

---- proj4 string

---- wkt string

-- layer_count 图层数量 number

-- layer_info 图层信息

array

---- bbox数据集外包矩形

object

------ max_x number

------ max_y number

------ min_x number

------ min_y number

----feature_count

要素数量 number

----feature_type

1点2线3面 number多点和点类型值相同，其他同理

---- fields_info 字段信息 object

------ index字段在图层中的索引

number

------ length 字段长度 number

------ name 字段名称 string


------ null 是否允许为空 stringnull 默认空，not null不为空

------ precision 精度 numberdouble类型精度

------ type字段mysql类型

string

------layer_index

图层索引 number

----layer_name

图层名称 string

-- tag_id 标签ID string

-- tag_name 标签名称 string

status 状态码 number


空




-- data_id 被删除的ID string

-- delete_rows 被删除的行数 number


3.2 指定ID-删除记录

请求类型： delete 请求URL：/ngse/v3/datasource/{id}?token= 接口描述： {id}替换为要删除的数据源ID 请求参数列表：


3.3 指定ID-编辑记录

请求类型： post 请求URL：/ngse/v3/datasource/{id}?token= 接口描述：可编辑某些字段数据。请求参数列表：

af://n722

af://n767


description 描述，可修改 string

name 名称，可修改 object string

tag_id 标签ID，可修改 string




-- data_id 被更新的ID string

-- upate_row 被更新的行数 number



空


3.4 指定ID-获取记录信息

请求类型： get "请求URL：/ngse/v3/datasource/{id}?token="" """ 接口描述：获取数据源记录的详细描述。请求参数列表：


af://n822



result object

-- data_id ID number



-- description 描述信息 string

-- info object

---- path 文件相对路径 array

---- root_type 根目录类型 string


-- tag_id 标签ID string

-- type 类型 number 0 矢量文件数据源

-- user_id 创建人id number


变量名

描述类型备注

name 数据源名称 string

op操作，create或create_client

stringcreate表示web端上传文件；create_client为客户端上传文件

tag_id 标签ID number

type 数据源类型 number "0通用类型(默认),1国军标"

3.5 数据源创建(zip提交)

请求类型： post 请求URL：/ngse/v3/datasource?token='' 接口描述：通过上传zip压缩包，创建数据源，支持多文件、目录嵌套、中文名称。请求参数为GET参数，数据通过POST提交。请求参数列表：


af://n912



result object

-- data_id 数据源ID string

status 状态 number


description 描述信息 string 可选参数


path 矢量文件路径 array

tag_id 标签ID number

type 数据源类型 number "0通用类型(默认),1国军标"



result object

-- data_id 数据源ID string




op check string

3.6 数据源创建(在线文件)

请求类型： post 请求URL：/ngse/v3/datasource?token='' 接口描述：通过选择服务器文件，创建数据源。请求参数列表：


3.7 datasource renaming check

请求类型： get 请求URL：/ngse/v3/datasource?token= 接口描述：无请求参数列表：


af://n967

af://n1027


message 消息 string

result object

-- datasource_count 已存在数量 number 等于0表示没有重名。



key 名称筛选 string

row 分页参数 number

start 分页参数 number



result object

-- item 结果列表 object

---- data_id id number

---- data_update_time 更新时间 number 格式：2017-01-01 00:00:00

---- name 名称 string

---- tag 标签名称 string

---- type 0，矢量文件数据源 number



id 数据源ID string

3.8 查询数据源列表

请求类型： get 请求URL：/ngse/v3/datasource?token= 接口描述：无请求参数列表：


3.9 获取图层列表

请求类型： get 请求URL：/ngse/v3/datasource/layer?token= 接口描述：无请求参数列表：

af://n1072

af://n1147



result object

--layer_count

图层数量 number

-- layer_info 列表

array

---- id 图层文件标识 number该标识对应文件

---- name 图层名称 string

---- path 所在路径 string

相对路径，可用于显示区分同名图层

---- type图层类型，1点，2线，3面

number



filetype 文件类型 string 过滤文件，支持shp、gdb、gjb


3.10 获取在线矢量文件列表

请求类型： get 请求URL：/ngse/v3/datasource/server_file?token= 接口描述： create a new data source anduse the server's existing files 请求参数列表：


af://n1212



result 矢量文件路径 array



crsid 坐标参考系id string "EPSG:4326,SESG:1001"

dataset_status 数据集状态 number"0不可用,1可用,2正在导入"

fields_list 字段列表

array

--cache 是否缓存 boolean

--index 索引类型 string 默认none无索引，key

--length 长度 number

--name 名称 string

--null 是否允许空 stringnull可为空，notnull 不能为空

--precision 精度 number double类型支持精度

--?type 类型 number

name 数据集名称 string

pv_config object

--map_level_list

array pv分层列表

tag_id 标签ID string

type数据集类型，1点2线3面

number

4 数据集管理

4.1 创建数据集

请求类型： post "请求URL： /ngse/v3/dataset?token="" """ 接口描述：无请求参数列表：

af://n1248

af://n1249




--data_id 数据集ID string



空






4.2 指定ID-删除数据集

请求类型： delete "请求URL： /ngse/v3/dataset/{id}?token="" """ 接口描述：无请求参数列表：


4.3 指定ID-更新数据集

请求类型： post "请求URL： /ngse/v3/dataset/{id}?token="" """ 接口描述：无请求参数列表：

af://n1359

af://n1395


dataset_status 数据集状态 number0运行，1停用，2正在导入数据

description 描述 string

fields_list 字段 object

注意不要删减字段中的参数，可以修改值

--cache显示字段，是否发布渐进传输

boolean

--index 索引类型 stringnone或key，key为普通索引

--length 长度 number

--name 字段名称 string

--null是否可以为空

stringnull或者notnull

--precision 精度 number

--type 类型 string

name 数据集名称 string

public 是否公开 number 0不公开 1公开

pv_config object

--level_list array

pv_optimization渐进传输避让、图元合并优化规则

object

--geo_avoid object 图元避让设置

----enable是否开启避让功能

boolean(2018.10.18，当不设置时默认开启避让)


----group_field

array

------name 字段名称 string

------not_null 是否不为空 boolean

如果为true，则当字段的值不为NULL时才参与避让

----?pixel避让像素范围

number

边长为pixel的正方形避让范围，默认为0.5像素

--geo_merge 图元融合 object 图元融合

----group_field

array

------name 字段名称 string

------not_null 是否不为空 string

--split_field 配置字段 object 分类分组字段

----name string

----type string


pv_rule渐进传输图元分级规则

array

--filtersql过滤条件

string

--max_level最大显示级别

number

--min_level最小显示级别

number





--data_id 数据集ID string string



空


4.4 指定ID-获取数据集详情

请求类型： post 请求URL：/ngse/v3/dataset/{id}?token= 接口描述：无请求参数列表：


af://n1596


status 错误信息 string

result object

-- bbox 外包矩形 object

---- min_y number

---- min_x number

---- max_y number

---- max_x number

-- crs 坐标参考系CRS object

---- crsid string

---- wkt string

---- proj4 string

data_update_user 创建日期 string

dataset_status ID string

data_version number

description 更新日期 string

name string

data_create_time number

data_status number

data_update_time

public

array

data_id 是否缓存 boolean

fields_list 索引类型 string

-- cache 长度 number


-- precision 名称 string

-- index 是否为空 string

-- name 精度 number

-- type 字段类型 string

-- null 数据集名称 string

-- length 是否公开 number"0私有, 1公开"

pv_info 渐进传输参数 object

-- pv_config object

---- level_list array

--pv_dataset_version

渐进传输文件对应数据集版本号

number

-- pv_optimization渐进传输发布优化规则

object

---- geo_avoid 避让设置 object

------ enable 是否开启 boolean

------ group_field 字段组合

array

-------- not_null 字段名称 string

-------- name 不能为空 boolean

如果为true，则当该字段为空时不进行避让

---- geo_merge 图元合并设置 object


------ enable 是否开启 boolean

------ group_field 字段组合

array

-------- not_null 字段名称 string

-------- name 不能为空 boolean

如果为true，则当该字段为空时不进行合并

-- pv_version渐进传输发布进度百分比

number

-- pv_update渐进传输发布级别设置

array

-- pv_status SQL过滤条件 string

-- pv_update_time 最大级别 number

-- pv_progress 最小级别 number

-- pv_rule 渐进传输状态 number

0未发布，1已发布，2正在发布

---- max_level number


---- min_level string

---- filter 版本号 number

-- type 是否发布WFS number0 否，1是

-- user_id 标签ID string

-- service_wfs 数据集类型 number点1 线2 面3

-- tag_id 创建人id string

message 错误码 number


noself 不包含自己的数据 boolean 为true时，过滤掉当前用户创建的记录



4.5 获取公开数据集列表

请求类型： get 请求URL：/ngse/v3/dataset/public?token= 接口描述：无请求参数列表：


af://n1906


status 消息 number

message string

result 结果列表 object

-- item object

---- bbox_min_y number

---- bbox_max_x 外包矩形 number

---- bbox_max_y number

---- bbox_min_x 坐标参考系 number

pv_rule object

-- crs object

---- proj4 string

---- wkt id string

---- crsid 更新时间 string 格式：2017-01-01 00:00:00


-- type 公开 number 1公开，0私有

-- data_update_time 渐进传输级别设置 number

-- pv_status 渐进传输状态 number 0未发布，1 已发布，2正在发布

-- tag_id WFS状态 number 0无，1开启WFS

-- user_id 标签ID number

-- public 类型 number 点1 线2 面3

-- data_id 创建者ID number

-- service_wfs 错误码 number


id 数据集ID string

4.6 获取数据集已有的地图

请求类型： get 请求URL： /ngse/v3/dataset/util?op=whichmap&token= 接口描述：通过数据集ID，查询用该数据集配图的地图ID列表请求参数列表：

af://n2046



result 结果 object

-- map_id 地图ID array



dataset_ids 数据集ID列表 array


pv_status 渐进传输状态 number 0否，1是


wfs WFS数据集 number 0否，1是


message错误信息

string

result object

-- item数据集列表

array

数据格式同获取指定ID的数据集信息接口result



4.7 获取数据集详情

请求类型： post 请求URL： /ngse/v3/dataset_info?token= 接口描述：按条件筛选获取数据集的详细信息请求参数列表：


af://n2091

af://n2152


ids id列表筛选 string ID之间英文逗号隔开


pv_status 渐进传输状态筛选 number "0,1,2"



tag_id 标签ID筛选 string

wfs WFS状态筛选 number 0或1

4.8 获取用户数据集列表

请求类型： get 请求URL： /ngse/v3/dataset?token= 接口描述：查询筛选数据集记录请求参数列表：


af://n2152


status 消息 number

message string

result 结果列表 object

-- item object

---- bbox_min_y number

---- bbox_max_x 外包矩形 number

---- bbox_max_y number

---- bbox_min_x 坐标参考系 number

---- crs object

------ crsid id string

-- data_id 更新时间 number 格式：2017-01-01 00:00:00

-- data_update_time 名称 number

-- name 公开 string 1公开，0私有

-- public 渐进传输 number

-- pv_info 发布状态 object 0未发布，1已发布，2发布中

---- pv_status WFS状态 number 0无，1开启WFS

-- tag_id 标签ID number

-- user_id 类型 number 点1 线2 面3

-- type 创建者ID number

-- service_wfs 错误码 number


id ID数组 array ID数组

open 公开设置，true或false boolean true表示设为公开，false表示不公开

type 类型，dataset或map string 按数据集ID或地图ID设置数据集是否公开

4.9 设置公开

请求类型： post 请求URL：/ngse/v3/dataset/public?token='' 接口描述：无请求参数列表：


af://n2303


message 消息 string 错误描述

result 返回数据 object 空

status 错误码 number 0成功，大于0失败


mission_command 命令 number 0导入

mission_id 任务ID string


message string

result object

status number

5 数据导入

5.1 启动导入任务

请求类型： post 请求URL：/ngse/v3/import/process?token 接口描述：无请求参数列表：


5.2 导入任务提交

请求类型： post 请求URL：/ngse/v3/import/mission?token= "接口描述： The front end is selected by theuser ,create the original coordinate file, and the data import task is submitted." 请求参数列表：

af://n2348

af://n2349

af://n2389


column_charset 数据集列表字符编码 string

content_charset 数据集属性字符编码 string

dataset_id 数据集id string

datasource 数据源信息 object

--dataset_name 数据集名称 string

--dataset_size 数据集图元数量 number

--file_path 文件路径 string

--id 数据源ID number

fields_list

array

--name 目标字段名 string

--src_name 源字段名 string

import_option选项，10新增，20追加

number

src_crs 源坐标参考系 object

--crsid csrid string

--name 名称 string


message 响应消息 string


-- data_id string



af://n2499


batch_id 批次ID string快速导入时批量创建任务的统一批次ID，可筛选避免ids过长

ids 通过id列表筛选 string

key 按数据集名称筛选 string

row"分页参数,返回行数"

number

start "分页参数,起始行" number 0开始

5.3 导入任务查询

请求类型： get 请求URL： /ngse/v3/import/mission?token= 接口描述：无请求参数列表：


af://n2499




--item 任务列表

array

----count_error 错误数量 number

----count_import 总图元数量 number

----count_success 成功数量 number

----data_id id number

----description 任务信息 string

----import_option 选项 string

----log_info 日志 string

----mission_command

-1未运行，0正在运行

number

----mission_process

进度百分比 number

----mission_status0未导入，1导入完成，2导入暂停，3撤销

number

----name 数据集名称 string

----tag_name 标签名称 string

----type源文件类型1点2线3面

string

--total_count 查询到记录总数 number


5.4 导入坐标参考系列表

af://n2630


空


空


content_encode 数据编码 string 默认GBK

datasource_name 数据源名称 string 必要字段

field_encode 字段名编码 string 默认GBK

op 上传方式 string默认create_web表示web方式上传，可选create_client

tag_id 标签ID string 若无该参数，以数据源名称创建标签

wait_finished是否等待导入结束

number默认0，0创建任务后立即返回，1等待全部导入完成后返回



result 返回数据 object

-- batch_id 批次ID string

-- mission_list 任务ID列表 array 创建的导入任务列表


请求类型： get 请求URL： /ngse/v3/import/projection 接口描述：无请求参数列表：


5.5 快速导入

请求类型： get 请求URL：/ngse/v3/import/upfile?token= 接口描述：上传数据并立即导入请求参数列表：


5.6 指定ID-删除任务

请求类型： delete "请求URL： /ngse/v3/import/mission/{id}?token="" """ 接口描述：无请求参数列表：

af://n2656

af://n2726


空






mission_command 0启动导入，2暂停，3撤销 number



result 返回结果 object



content 符号库数据 string

description 描述说明 string 最多1000字符

name 名称 string

public 是否公开 number 1公开 0不公开默认0


5.7 指定ID-更改任务状态

请求类型： post 请求URL： /ngse/v3/import/mission/{id}?token='' 接口描述：启动、暂停、撤销导入任务请求参数列表：


6 符号库

6.1 创建符号库

请求类型： post 请求URL：/ngse/v3/symbolic_library?token 接口描述：空请求参数列表：

af://n2762

af://n2797

af://n2798



result object

--data_id 符号库ID



空




--data_id

--delete_rows 成功删除的函数




description 描述可编辑 string

name 名称可编辑 string

public 是否公开 number 1公开


6.2 指定ID-删除

请求类型： delete 请求URL：/ngse/v3/symbolic_library/{id}?token= 接口描述：空请求参数列表：


6.3 指定ID-更新

请求类型： post 请求URL： /ngse/v3/symbolic_library/{id}?token= 接口描述：空请求参数列表：


af://n2853

af://n2898




--data_id

--update_rows 成功更新的行数




description 描述可编辑 string 最多1000字符

name 名称可编辑 string

public 是否公开 number 1 公开 0不公开







public 是否公开 number 1获取公共符号库列表，0或不传获取当前用户列表

row "分页参数,返回行数" string

start "分页参数,起始行" number 0开始

6.4 指定ID-获取

请求类型： get 请求URL： /ngse/v3/symbolic_library/{id}?token= 接口描述：空请求参数列表：


6.5 获取符号库列表

请求类型： get 请求URL： /ngse/v3/symbolic_library/{id}?token= 接口描述：空请求参数列表：


af://n2958

af://n3008




--item 列表

array

----data_id ID number

----data_version

版本号 number

----description 描述 string

----name 名称 string

----public 是否公开 number1公开0私有

----user_id 用户D number

--total_count查询到记录总数

number


7 地图

7.1 渲染

请求类型： post "请求URL：/ngse/v3/render?token="" """ 接口描述：用户可查询获取任意形状范围内的要素进行显示，并且可带属性过滤条件（前端可能指定按属性设置不同的渲染样式）。请求参数列表：

af://n3099

af://n3100


dataset_list 数据集信息

array

--avoid_overlapping

是否做遮挡避让计算，只对点图层有效

boolean

--dataset_id 数据集id number

--dataset_ver 数据集版本 number

--feature_id_list

只有在该集合中的图元才能显示，主要用于WMTS或者切片数据渲染情况下显示选中的数据集

array

--field_in_cache

字段值是否在缓存中获取，打开已有的地图该值应为true，用户自配置地图应为false

boolean

--field_list要获取属性的字段集合

array

--filter 属性过滤条件 string

--geo_clip 线面要素是否裁剪 boolean

--layer_id 数据集对应图层的id number

query_define 查询条件 object

--bbox

查询矩形范围，如果不是矩形查询，则存储其他范围查询形状的外包矩形

object

--max_x 最大X number

--max_y 最大Y number

--min_x 最小X number


--min_y 最小Y number

--center查询圆形范围的中心点

object

--x

--y

--feature用于空间查询的图元，GeoJson格式表示

string

--projection描述查询范围的坐标系

object

--epsg_id number

--proj4proj4格式的字符串表示

string

--wktwkt格式的字符串表示

string

--radius 查询圆形范围的半径 number

--type 查询类型 number

view_bbox当前查询范围对应的视图大小

object

--max_x 最大X number

--max_y 最大Y number

--min_x 最小X number

--min_y 最小Y number



message 接口版本 string

interface_ver 错误信息 string

result object

-- dataset_list 数据集信息 object

---- attr_list 属性值集合 string

---- dataset_id 数据集id，直接从Request对应图层的dataset_id获取 string

---- dataset_ver 数据集版本 string

----feature_id_list

要素id集合 object

---- field_list要获取属性的字段集合，直接从Request对应图层的field_list获取

string

---- geo_list 要素集合，超擎压缩格式转换为16进制字符串 object

---- layer_id数据集对应的图层的id，直接从Request对应图层的layer_id获取

string

---- separator 压缩图元还原参数 string

-- map_bbox 地图范围，直接从Request.query_define.bounds获取 object

---- max_x 最大X number

---- max_y 最大Y number

---- min_x 最小X number

---- min_y 最小Y number

-- view_bbox 地图范围对应的视图大小，直接从Request.view_bbox获取 object

---- max_x 最大X number

---- max_y 最小X number

---- min_x 最小Y number

---- min_y 最小Y number

status 错误码，表示请求执行结果 number

7.2 保存地图

请求类型： post "请求URL：/ngse/v3/map?token="" """ 接口描述：空请求参数列表：

af://n3386


bbox 首屏外包矩形 object

--max_x number

--max_y number

--min_x number

--min_y number

crsid 坐标参考系编号 string EPSG:4326/SESG:1001

data_type 数据类型：1数据库，2渐进传输 number 可选，默认1

dataset_list 包含的数据集ID array "[a,2,3]"

name 地图名称 string

public 是否公开 number 0否，1是

style style.json样式数据 string

thumbnail 缩略图 string web格式：base64编码格式




--data_id 新建地图ID string



7.3 地图服务-创建WMTS

请求类型： post "请求URL：/ngse/v3/map/service?token="" """ 接口描述：空请求参数列表：

af://n3482


config 服务配置 object

url string

map_id 内部地图ID string 外部地图不需要该参数

name 服务名称 string

source_type 数据来源 number 1内部地图 2外部地图

thumbnail 缩略图 string

type 服务类型 string wmts



result object

--data_id 服务ID string

status 状态码 number 0成功 1失败


空


7.4 地图服务-指定ID读取信息

请求类型： post "请求URL：/ngse/v3/map/service?token="" """ 接口描述：空请求参数列表：


af://n3552


message string

result object

--config object

--data_create_time string

--data_id string

--data_version number

--map_id string

--name string

--source_type number

--thumbnail 缩略图 string

--type string

--user_id string

status number


key 名称 string

7.5 地图服务-查询列表

请求类型： get 请求URL： /ngse/v3/map/service?token= 接口描述：空请求参数列表：


| type | 类型 | key | name | string wmrts

af://n3637


message string

result object

--item

array

----config object

----data_id string

----data_version number

----map_id string

----name string

----source_type number

----type string

status number


空




-- data_id 被删除的ID string

--delete_rows 成功删除的行数 number


7.6 指定ID-删除地图

请求类型： delete 请求URL： /ngse/v3/map/{id}?token= 接口描述：{id}替换为要删除的地图ID 请求参数列表：


af://n3713

af://n3758


空



result object

--bbox 首屏外包矩形 object

----max_x number

----max_y number

----min_x number

----min_y number

--crs 地图坐标参考系 object

----crsid EPSG:4326 string

----proj4 string

----wkt string

--data_id 地图id string

--data_status 地图服务状态 number 1运行 0停用

--data_type 数据类型：1数据库，2渐进传输 number 1矢量地图 2流式地图

--dataset_list 数据集编号列表 array

--name 地图名称 string

--public 是否公开地图 boolean 1公开 0私有

--style 样式数据 string

--user_id 创建人id number


7.7 指定ID-打开地图

请求类型： get "请求URL： /ngse/v3/map/{id}?token="" """ 接口描述：获取地图信息，包含style.json 请求参数列表：


7.8 指定ID-更新地图

af://n3758

af://n3878


bbox 外包矩形 object 可选择某几项更新

--max_x number

--max_y number

--min_x number

--min_y number

data_type 数据来源 number 1数据库，2渐进传输

dataset_list 数据集列表 array

map_status 地图状态 number 0停止使用，1正常

name 名称 string

public 是否公开 number 0私有化，1公开化

style 样式数据 string




-- data_id string

--update_rows number


请求类型： post "请求URL： /ngse/v3/map/{id}?token=""" 接口描述：空请求参数列表：


7.9 查询个人地图列表

请求类型： get 请求URL： /ngse/v3/map?token= 接口描述：请求地图列表，只显示当前用户请求参数列表：

af://n3973


data_type 数据类型 number 可选，m1数据库，2渐进传输

key 地图名称筛选 string 可选

public 是否公开 number 0无，1公开

pv_status 渐进传输状态 number 0无，1有

row "分页参数,返回行数" number

start "分页参数,起始记录" number 0开始




result object

--item 地图集合

array

----bbox 外包矩形 object

------max_x number

------max_y number

------min_x number

------min_y number

----crs 坐标参考系 object

------crsid 标识 string

----data_id 地图id string

----data_type1数据库，2渐进传输

number

----data_version

地图版本号 number

----name 地图名称 string

----public 是否公开 boolean 0否，1是

----pv_status 渐进传输状态 number0 无 1已发布

----user_id 地图创建人ID number

--total_count 查询结果数量 number


7.10 查询公开地图列表

请求类型： get 请求URL： /ngse/v3/map/public 接口描述：请求公开地图列表请求参数列表：

af://n4113


data_type 数据来源 number 1数据库 2渐进传输

key 名称过滤，可选参数 string

pv_status 渐进传输发布状态 number 1已发布，0未发布，2正在发布

row 行数，分页查询 number

start 起始行，分页查询 number 可选参数，0开始




result object

--item 地图集合

array

----data_version

地图版本号 number

----id 地图id number

----name 地图名称 string

----public 是否公有 boolean

----pv_exist渐进传输，0已发布，1未发布，2正在发布

number

----style_id 默认样式ID number

----style_version

默认样式版本号 number

----thumbnail

地图缩略图文件url地址 string

----tile_exist切片状态，0已切片，1未切片，2正在切片

boolean

----user_id 地图创建人ID number

----user_name

创建人 string

--total_count 查询结果总数量 number


7.11 map service --get thumbnail

请求类型： post 请求URL： /ngse/v3/map/thumbnail 接口描述：请求参数列表：

af://n4233


id 地图ID string




-- thumbnail 缩略图 string



8 数据编辑

8.1 要素增删改

请求类型： post "请求URL： /ngse/v3/edit?token="" """ 接口描述：有任意一个要素操作失败则认为整个操作失败请求参数列表：

af://n4274

af://n4275


dataset_list

array



--feature_create_list

增加的要素集合，GeoJson格式，包含图元和属性，se_id都为-1

array

--feature_delete_list

要删除要素的id集合

array

--feature_update_list

要修改的要素集合，GeoJson格式，包含图元和属性，se_id也必须在该结构内存

array

--sub_dataset_id 子数据集ID number




result object

--dataset_list

array

----bbox

数据集新的范围，修改图元可能会改变范围

array

----dataset_id 数据集id number

----dataset_ver 数据集版本 number

----feature_added_list

增加成功的图元id

array

2017.09.28廖涛南京公安项目需求，需要根据返回图元id更改其他关联表单

----message编辑失败消息

string

----status数据集更新是否成功标识

number0成功，1失败



dataset_list 要解锁的数据集列表 array

8.2 解锁全部要素

请求类型： post "请求URL： /ngse/v3/edit/lock?op=unlock_all?token="" """ 接口描述：请求参数列表：


af://n4376




status 错误状态 number


dataset_list

array



--feature_id_list 要素ID列表 array




status 错误状态 number

8.3 解锁要素

请求类型： post "请求URL： /ngse/v3/edit/lock?op=unlock?token="" """ 接口描述：请求参数列表：


8.4 锁定要素

请求类型： post "请求URL： /ngse/v3/edit/lock?op=lock?token="" """ 接口描述：在用户要对要素和其属性进行编辑操作之前，必须要先请求锁定图元，以防止多个用户同时对同一图元进行编辑，出现数据不一致问题。用户可提交多个图元进行锁定，但有可能只有部分图元锁定成功。锁定主体是用户。请求参数列表：

af://n4412

af://n4462


dataset_list要锁定的数据集集合

array



--feature_id_list

要锁定的图元的id array




result object

--dataset_list

数据集集合

array

----dataset_id

数据集id number

----dataset_ver

数据集版本 number

----succes_list

锁定成功的图元id列表 array

----user_list指示锁定失败的图元是被那些用户锁定的

array

------fail_list 锁定失败的图元id集合 array

------user_name

用户名 string


?

9 查询统计

9.1 叠加分析

请求类型： post "请求URL：/ngse/v1/overlay?token="" """ 接口描述：无请求参数列表：

af://n4548

af://n4549


dataset 做叠加分析的目标数据集 object



--field_list 查询的字段集合 array


--layer_id 图层ID number

--min_area

最小面积，忽略小于该面积的叠加分析结果，该值在need_area为true时有效

number

--need_area是否获取叠加结果的面积，默认为false

boolean

--overlay_type对该数据集的叠加分析类型，目前只支持opIntersect（值3）

number

"opClip=0,//!裁剪opUnion, //!合并opErase, //!擦除opIntersect,//!求交opIdentity//!同一"

overlay_condition 叠加条件 object

--feature_list做叠加分析的要素集合，必须是面或者多面，GeoJSON格式

array

--projection 坐标系信息 object

----epsg_id number

----name 名字，可修改 string

----proj4 proj4格式的字符串表示 string

----wkt wkt格式的字符串表示 string


--bbox 查询地图范围 object

----max_x 最大X number


----max_y 最大Y number

----min_x 最小X number

----min_y 最小Y number

--center 圆形查询的中心点 object

----x

----y

--feature查询的图形范围，GeoJSON格式表示

object

--projection 描述查询范围的坐标系 object

----epsg_id number

----proj4 proj4格式的字符串表示 string

----wkt wkt格式的字符串表示 string

--radius 圆形查询的中心点 number





result object

--dataset object

----area_list 图元面积集合 array

----attr_list 属性值集合 array

----dataset_id 数据集ID number

----dataset_ver


----feature_id_list

要素ID集合，如果不为空，那么只有在该集合中的要素才需要显示

array

----feature_list叠加分析的结果集合，GeoJSON格式

array

----field_list 查询的字段集合 array

----layer_id 图层ID number

----overlay_type

叠加分析类型 number


9.2 地名地址查询

请求类型： post 请求URL：/ngse/v3/addr/search?token= 接口描述：通过关键字查询地址，通过坐标定位地址请求参数列表：

af://n4789


adress 地址字段名 string

dataset_id 数据集id string

name 地名字段名 string

points 搜索范围 array "格式为[x,y,x,y,...]"

words 搜索关键字，关键字间以空格分割 string



result object

--dataset_id 数据集ID string



空



result object

--feature_info 属性信息，GeoJson格式，根节点是feature object



9.3 地名地址要素详细信息查询

请求类型： get 请求URL： /ngse/v3/addr/search/{id}&token= 接口描述：查询地名地址要素的详细信息请求参数列表：


9.4 数据集属性统计

请求类型： get 请求URL： /ngse/v3/dataset_util?op=statistics&token= 接口描述：支持max、min、count、sum、求比例等统计请求参数列表：

af://n4849

af://n4890


dataset_list 数据集列表

array


--values_count 计数 array

--values_max 求最大值 array

--values_max_scale_of_sum

求字段占总和比例最大值

array

--values_min 求最小值 array

--values_min_scale_of_sum

求字段占总和比例最小值

array

--values_sum 求和 array




array


--values_count 计数 array

--values_max 求最大值 array

--values_max_scale_of_sum

求字段占总和比例最大值

array

--values_min 求最小值 array

--values_min_scale_of_sum

求字段占总和比例最小值

array

--values_sum 求和 array

9.5 空间查询

请求类型： post "请求URL： /ngse/v1/query?token="" """ 接口描述：即包含属性过滤条件的各类空间查询。如既不获取图元也不获取属性，则只返回ID集合请求参数列表：

af://n4986


dataset_list 数据集信息

array

--count需要获取的要素的数量

number



--feature_id_list

要查询的要素id集合，对应query_define的IDS查询类型

array

--field_list 查询的字段集合 array


--flow_dt 是否为流式数据集 boolean

--layer_id 数据集对应的图层id number

--orderby 排序条件 string

--query_geo 是否获取图元 boolean

effective_dataset_count需要查询得到多少有效数据集结果

number


--bounds 范围查询 object

----max_x 最大X number

----max_y 最大Y number

----min_x 最小X number

----min_y 最小Y number

--center 圆形查询的中心点 object

----x

----y

--feature空间查询图元，GeoJson格式

string


--projection描述查询范围的坐标系

object

----epsg_id number

----proj4proj4格式的字符串表示

string

----wktwkt格式的字符串表示

string

--radius 圆形查询的中心点 number





result object

--dataset_list

array

----attr_list 属性值集合 array

----dataset_id数据集id，值从Request对应图层的dataset_id获取

number

----dataset_ver 数据集版本 number

----feature_id_list 要素id集合 array

----field_list字段集合，直接从Request对应图层的field_list获取

array

----geo_format图元格式，GeoJson格式还是自有格式

number

----geo_list 图元集合 array

----layer_id图层id，值从Request对应图层的layer_id获取

number

----query_geo

是否获取图元，值从Request对应图层的query_geo获取

boolean

--effective_dataset_count

需要查询得到多少有效数据集结果

number


9.6 统计（热力图）

af://n5212

请求类型： post "请求URL： /ngse/v1/statistics?token=""""" 接口描述：多区域统计，目前只支持同时统计多个区域内点图元的个数请求参数列表：


extent_list 要统计的范围的集合

array

--dataset_list 数据集集合

array

----dataset_id 数据集ID number

----dataset_ver


----layer_id 图层ID number

--query_define

查询条件 object

----bbox 查询地图范围 object

------max_x 最大X number

------max_y 最大Y number

------min_x 最小X number

------min_y 最小Y number

----center 圆形查询的中心点 object

------x

------y

----feature查询的图形范围，GeoJSON格式表示

object

----projection 描述查询范围的坐标系 object


------epsg_id number

------proj4 proj4格式的字符串表示 string

------wkt wkt格式的字符串表示 string

----radius 圆形查询的中心点 number

----type 查询类型 number




result object

--extent_list 统计范围集合

array

----message 错误信息 string

----result object

------dataset_list 数据集集合

array

--------dataset_id 数据集ID number

--------dataset_ver


--------layer_id 图层ID number

--------total数据集总统计值

number

--------value 统计值 number

----status 错误码 number


9.7 获取数据集字段唯一值

请求类型： post 请求URL： /ngse/v3/dataset_util?op=get_field_distinct&token= 接口描述：无请求参数列表：

af://n5398


dataset_list数据集列表

array

--dataset_id

数据集ID number

--field_name

字段列表 array"如：""市"",""路名"""

--filter 过滤条件 string sql条件



result 返回数据

array

--dataset_id 数据集ID number

--field_name 字段列表 array

--value_list 唯一值数组 array



10 渐进传输服务

10.1 发布渐进传输

请求类型： post 请求URL：/ngse/v3/se_pv/publish?token= 接口描述：无请求参数列表：

af://n5464

af://n5465


crsid 数据集的坐标参考系编码 string 如EPSG:4326

dataset_list 数据集ID列表 array

map_id 地图ID string 发布完后，通过该ID更新地图状态



result 结果信息 string



cmd getdatainfo

name 数据集ID string

token 安全令牌 string




--bound 外包矩形 array

--count 图元数量 number

--field 字段信息 array

--name 数据集名称 string

--precision 坐标精度 number

--type 类型 string

status 错误码


10.2 读取图层信息

请求类型： get 请求URL：se/v3/se_pv/query 接口描述：无请求参数列表：


af://n5510

af://n5586


cmd getshapes string


array

--data_list 数据列表

array

----from number

----key key number

----to number

----type 类型 string


--dataset_ver 数据集版本号 number


空

10.3 读取图层组

请求类型： post 请求URL： /ngse/v3/se_pv/query?token= 接口描述：无请求参数列表：


10.4 读取索引

请求类型： post 请求URL： /ngse/v3/se_pv/query?token= 接口描述：无请求参数列表：

af://n5586

af://n5652


cmd getindex string


array




空


map_id 地图ID number



result 返回数据 string

status 错误码 string


11 WFS

11.1 发布地图为WFS

请求类型： post 请求URL：/ngse/v3/wfs/publish?token= 接口描述：无请求参数列表：


11.2 发布数据集为WFS

请求类型： post 请求URL：/ngse/v3/wfs/publish?token= 接口描述：无请求参数列表：

af://n5693

af://n5694

af://n5730


dataset_id 数据集ID number


空


map_id 地图ID number


空


dataset_id 数据集ID number


空


11.3 撤销地图下数据集wfs状态

请求类型： delete 请求URL：/ngse/v3/wfs/publish?token= 接口描述：无请求参数列表：


11.4 撤销数据集WFS状态

请求类型： delete 请求URL：/ngse/v3/wfs/publish?token= 接口描述：无请求参数列表：


12 数据导出

12.1 启动导出任务

请求类型： post 请求URL： /ngse/v3/export/process?token 接口描述：无请求参数列表：

af://n5756

af://n5782

af://n5808

af://n5809


mission_id 导出任务ID number



result object



crs 坐标系 object

crsid string

proj4 string

wkt string

datasource_id 数据源id string

mapsheet_list 图幅号列表 array

name 导出任务名称 string



result object

id 导出任务id array



11.2 按图幅导出任务提交

请求类型： get 请求URL： /ngse/v3/export/vector?token= 接口描述：按照图幅创建导出任务请求参数列表：


12.3 按范围导出任务提交

请求类型： post 请求URL：/ngse/v3/export/vector?token= 接口描述：前端提交导出任务信息请求参数列表：

af://n5845

af://n5916


crs 坐标系 object

crsid string

proj4 string

wkt string


array

dataset_id 数据集id，字符串格式 string

field_list 导出的字段列表 array

file_name 导出的文件名 string

filter 过滤条件 string

feature 限定范围，GeoJson格式 object

geo_clip是否使用限定范围做图元裁剪

boolean

name 导出任务名称 string

shp_file用作限定范围的shp文件路径，当feature为空时该值才有效

string




id 创建的导出任务ID string



12.4 查询任务列表

af://n6017



row number

start number

token string

请求类型： get 请求URL： /ngse/v3/export/vector?token= 接口描述：无请求参数列表：




result object

item

array

data_create_time string

data_id string

data_status number

data_update_time string

data_update_user string

data_version number

description 描述 string

mission_status任务状态，0:未开始，1:完成，2正在处理，3:异常停止

number

mission_type任务类型:1普通导出，2图幅导出

number

name 名称 string

progress "进度,百分比" number

user_id string

total_count number


13 目录管理

13.1 创建目录

af://n6138

af://n6139


cname 目录名称 string

upid 上级目录id string 最顶层用0表示



result object

data_id 新建的目录ID string



空


message string

result object

data_id 被删除记录的id string

status number


cname 名称 string

upid 上级id string 0为最顶层

请求类型： post 请求URL： /ngse/v3/catalog?token= 接口描述：无请求参数列表：


13.2 指定ID-删除

请求类型： delete 请求URL： /ngse/v3/catalog/{id}?token= 接口描述：无请求参数列表：


13.3 指定ID-更新

请求类型： post 请求URL： /ngse/v3/catalog/{id} 接口描述：无请求参数列表：


af://n6184

af://n6225


message string

result object

data_id id string

status number


空


message string

result object

cname 名称 string

data_create_time string

data_id id string

data_update_time string

upid 上级id string

user_id 创建人ID string

status number


catalog_id 目录ID string

dataset_id 数据集ID列表 array

13.4 指定ID-查询详情

请求类型： get 请求URL： /ngse/v3/catalog/{id}?token= 接口描述：无请求参数列表：


13.5 更新数据集所属目录

请求类型： post 请求URL： /ngse/v3/dataset/util?op=catalog 接口描述：无请求参数列表：

status

af://n6272

af://n6338


message string

result object

result string ok

status number


start string

upid 上级目录ID string


message 信息 string

result object

item

array

cname目录名称

string

data_create_time创建日期

string

data_id id string

upid 上级ID string0表示最顶层



13.6 查询目录列表

请求类型： get 请求URL： /ngse/v3/catalog?token 接口描述：无请求参数列表：


af://n6384

Documents

超擎时空大数据服务平台接口文档 1.1 匹配 ... · 变量名 描述 类型 备注 crsid 标识 string 匹配优先级：1 epsg EPSG ID string 匹配优先级：2 name

超擎时空大数据服务平台接口文档 1.1 匹配 ... · 变量名描述类型备注 crsid 标识 string 匹配优先级：1 epsg EPSG ID string 匹配优先级：2 name