通过ids获取要素集合(featureByIDs)

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

layerId

string

必需

图层Id，优先级高于layerName

layerName

string

图层名

必需

datasourceID

string

必需

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

datasourceName

string

数据源名称

必需

parentDatasetName

string

可选

父数据集名称, 对于名称对外重复的情况下会需要，比如海图

datasetName

string

数据集名称

必需

datasetID

string

可选

每个数据集对应一个唯一标识ID，可替换数据源名称+数据集名称确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高

ids

array[integer]

过滤OID数组

必需

outSRS

string

可选

结果数据集的空间参考

hasGeometry

boolean

可选

是否返回要素图形信息，默认为true，返回要素图形信息。false时，不返回要素图形信息

returnZM

boolean

可选

是否返回图形信息里面的ZM值(如果有的话)，默认为true, hasGeometry为true的时候才有用

returnBlobField

boolean

可选

是否返回属性值的二进制属性内容，默认为false, returnContent 为true的时候才有用, 返回形式为base64编码

connInfo

object (ConnectionInfo)

可选

【connInfo`对象】支持的对象数据源连接信息，动态打开数据源，功能和其他datasourceID和datasourceName、destDatasetName、datasetName等参数的组合类似，互斥关系，且优先级优先级高于其他组合。该参数用于全局通用数据服务，根据临时连接信息动态打开数据源或数据集

connecttype

string

必需

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

filepath

string

可选

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

server

string

可选

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

instance

string

可选

数据库实例名或端口

database

string

数据库名称

可选

user

string

数据源用户名

可选

password

string

数据库密码

可选

dataset_name

string

表名

可选

示例

{
    "datasourceName": "china",
    "datasetName": "road",
    "ids": [
        "id1",
        "id2"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/rest/services//data/featurebyIDs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasourceName": "china",
    "datasetName": "road",
    "ids": [
        "id1",
        "id2"
    ]
}'

返回响应

🟢200成功

application/json

Body

result

object

必需

featureCount

integer

必需

features

object

必需

geometryType

string

必需

startID

integer

必需

resultcode

string

必需

示例

{
    "resultcode": "success",//返回结果代码，”success”表示成功，”error”表示失败
    "result":
    {
       "features":{featureCollection object},//返回要素集合
       "featureCount":186,//要素集中要素的总数量。
       "geometryType":"Line",//几何类型，对应几何对象枚举
       "startID":0 //要素集合中要素的起始ID
    }
}