batchQuery

http://172.16.1.44:9800

POST

/rest/services/{servicename}/data/batchquery

对多个数据集同时进行批量查询。

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法batchquery

layerName

array[string]

必需

图层名称数组，如果不设置，则获取全部图层的信息

layerId

array[string]

必需

图层id数组，如果不设置，则获取全部图层的信息。和layerName效果一致，需要具有唯一性。优先级高于layerName

scale

number

可选

地图比例尺，用于判断图层是否在显示范围内，如果不设置，则不判断，所有传入图层认为均可查询

mode

number

可选

查询模式有top、 visible和all三种，默认all。分别代表最上层，可见和全部

tolerance

integer

可选

屏幕像素与应执行识别操作的指定几何图形的距离。容差的值是一个整数。根据传入的几何及空间参考，转换成对应的地理坐标。当传入图形是点时默认 tolerance=2，当传入图形不是点时默认 tolerance=0

dpi

integer

可选

每英寸点数，默认96

datasetName

array[string]

数据集名称

必需

datasourceName

array[string]

数据源名称

必需

datasourceID

array[string]

可选

资源ID,和datasourceName功能相同，用于确定数据源。服务重启（持久化后再加载）保证一致性。二选一

filter

object

必需

查询过滤条件对象，请参考Filter对象,。查询条件，数量为1或者和查询数据集数量相同。数量为1时，所有查询图层均使用相同查询条件，否则按照对应索引匹配对应数据集的查询条件

where

string

查询过滤条件

可选

subfields

string

可选

查询返回的字段，以逗号隔开，例如：PAC,NAME

geometry

object

可选

查询几何对象，geojson格式字符串

geoSRS

string

可选

查询几何对象的空间参考信息，支持EPSG、WKT、proj4字符串参数，例如epsg类型 EPSG:4490

SpatialRel

string

可选

查询空间判断过滤类型

limit

string

可选

限制返回数量，默认全部返回

GroupByClause

string

可选

分组条件，sdk底层支持，传入参数字段名称，多个字段以 , 逗号分割，例如 id,name

OrderByClause

string

可选

排序条件，sdk底层支持，传入参数字段名称 + desc/asc，多个字段排序使用 , 逗号分割。举例： id desc,name asc

asyn

boolean

可选

false表示直接返回查询结果，即元素类型为 Feature 的数组;true表示异步执行查询，返回创建的 featureResult 资源的 name。默认不传时为 true

returnContent

boolean

可选

是否返回要素信息（属性和图形信息），默认为false，只返回要素的id。true时，返回要素信息

hasGeometry

boolean

可选

是否返回要素图形信息，默认为false，不返回要素图形信息，true时，返回要素图形信息。在returnContent为true、sync为false时，该参数有效

outSRS

object

必需

输出空间参考，所有数据集查询结果均按照该空间参考进行查询。如果未设置则按照数据集空间参考返回

fromIndex

integer

可选

查询结果的起始索引号，默认值是0，如果该值大于查询结果的最大索引号，则查询结果为空

toIndex

integer

可选

如果该值大于查询结果的最大索引号，则以查询结果的最大索引号为终止索引号。
如果设置了此值，则必须大于fromIndex，如果小于fromIndex，则查询为错误；设置了此值，但是值无效，则会默认为19
没设置此值时，返回所有，可能会比较慢

connInfo

object (ConnectionInfo)

可选

数据源连接信息，动态打开数据源，功能和其他datasourceID和datasourceName、destDatasetName、datasetName等参数的组合类似，互斥关系，且优先级优先级高于其他组合。该参数用于全局通用数据服务，根据临时连接信息动态打开数据源或数据集。此时应该使用的是datasetName,由于未发布，并没有相关ID

connecttype

string

必需

数据源类型，支持 Folder,RelationalDB_Access,KQSpatialDB,KQPostgisDB,RelationalDB_PostgreSQL,RelationalDB_Kingbase8,RelationalDB_MySql,RelationalDB_SQL,RelationalDB_OCI11,RelationalDB_DM,S57,GDB,GeoJSON。

filepath

string

可选

文件路径，当数据源为文件或文件目录时有效，数据源类型为Folder,RelationalDB_Access,KQSpatialDB为文件型数据源。

folderpath

string

可选

文件夹路径，当数据源为文件或文件目录时有效，数据源类型为Folder

server

string

可选

数据库服务器地址(IP或机器名)

instance

string

可选

数据库实例名或端口

database

string

数据库名称

可选

user

string

数据源用户名

可选

password

string

数据库密码

可选

dataset_name

string

表名

可选

示例

{
    "request": "batchquery",
    "datasourceName":["china"],
    "datasetName":["road"],
    "filter":["filter object"],
    "returnContent":true,
    "hasGeometry":true,
    "asyn":false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://172.16.1.44:9800/rest/services//data/batchquery' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "batchquery",
    "datasourceName":["china"],
    "datasetName":["road"],
    "filter":["filter object"],
    "returnContent":true,
    "hasGeometry":true,
    "asyn":false
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

同步返回结果异步返回结果

{
    "resultcode": "success",
    "result": [
        {
            "layerId": "layer1",
            "datasetName": "name1",
            "datasourceName": "ds1",
            "featureCount": 10,
            "featureIDs": [],
            "features": "{FeatureCollection GeoJson object}",
            "totalCount": 100
        }
    ]
}

修改于 2023-06-06 02:03:23

identify

getTile