数据集字段统计(statistic)

POST

/rest/services/{servicename}/data/statistic

针对数据集中的一个字段进行统计。支持批量统计。

NOTE:

对于分组的情况，暂时只支持MAX（最大），MIN（最小），AVERAGE（平均），SUM（求和）；并返回每个分组的要素数量（count)；
对于统计来说，统计的要素的数量有filter里面的limit参数设置决定，没有走服务配置里面的参数；
precision 参数只负责的是double类型返回为字符串时的精度问题，对于double原值的精度显示由ui(web)自己控制；
statisticInfos 与 retFeaCount 俩个至少返回一个；

请求示例

示例1无分组的情况

{
    "datasourceName": "china",
    "datasetName": "road",
    "statisticinfos": [
        {
            "length": "MIN"
        }, // 获取字段length的最小值
        {
            "area": "MAX"
        },// 获取字段area的最大值
      {
            "name":"UNIQUEVALUE",
            "limit": 10
        } // 获取name的唯一值，limit设置的获取个数
    ],
  "retFeaCount": false // 不返回要素数量
}

示例2分组统计

{
    "datasourceName": "SQL202210211716",
    "datasetName": "DLTB",
    "statisticinfos": [
        {
            "TBMJ": "MIN"
        }, // 获取字段TBMJ的最小值
        {
            "TBDLMJ": "MAX"
        } // 获取字段TBJLMJ的最大值
    ],
    "filter": { // 分组过滤条件
        // 按地理名称进行分组
        "GroupByClause": "DLMC" // 这里的DLMC是字段名
    },
"retFeaCount": true // 返回要素数量
}

示例3只统计过滤条件内的要素个数

{
  "datasourceName":"SQL202210211716",
  "datasetName":"DLTB",
   "filter": {"geometry":{"type":"GeometryCollection","geometries":[{"type":"Polygon","coordinates":[[[114.4909286499,30.5701446533],[114.4909286499,30.5907440186],[114.5166778564,30.5907440186],[114.5166778564,30.5701446533],[114.4909286499,30.5701446533]]]}]},"SpatialRel":"Intersects","geoSRS":"EPSG:4326","where":""},
  "retFeaCount": true // 返回要素数量
}

请求参数

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，可替换数据源名称+数据集名称确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高

statisticinfos

array [object {1}]

可选

字段统计信息数组，格式 [{"字段名称":"统计模式"}],统计模式支持:
MAX 统计所选字段的最大值
MIN 统计所选字段的最小值
AVERAGE 统计所选字段的平均值
STDDEVIATION 统计所选字段的标准差
SUM 统计所选字段的总和
VARIANCE 统计所选字段的方差
UNIQUEVALUE 获取字段的唯一值, 不传时默认limit为10，传-1时返回所有,有分组的情况下不支持

TBDLMJ

string

可选

filter

object (Filter)

可选

查询过滤条件对象，通过分组属性，支持分组进行统计, 特殊情况：shp数据不支持分组统计

where

string

可选

查询条件，使用url编码之后的字符串，例如 PAC=420804 or PAC=420802

geometry

string

可选

查询几何对象，geojson格式字符串，具体参见 “geojson 对象” geojson 对象
此参数如果在设置了query_define 中的geometry 参数后，会无效，会被覆盖。需要对字符串进行转义，例如：{ "type": "Polygon", "coordinates": [ [ [ 111.989792031851962, 31.427141945448305 ], [ 111.556656081144411, 30.94937986648603 ], [ 112.147296013927445, 30.639622035070929 ], [ 112.562056500059526, 30.999256127476599 ], [ 111.989792031851962, 31.427141945448305 ] ] ] }

subfields

string

可选

查询返回的字段，以逗号隔开，如果为空，则返回所有字段，例如：PAC,NAME

GroupByClause

string

可选

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

OrderByClause

string

可选

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

SpatialRel

string

可选

查询空间判断过滤类型

limit

string

可选

制返回数量，默认全部返回，如果传值小于0 则设置为200

Fids

array[string]

可选

过滤要素id数组,优先级最高

geoSRS

string

可选

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

onlyPublish

boolean

可选

查询的时候是否只查询已发布的数据，默认为false, 所有都可查询新增,已支持

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

表名

可选

precision

integer

可选

涉及double类型字段值返回为字符串时候的精度,不传时默认-1，代表使用字段本身的精度, 合理的精度应该是0到字段精度

retFeaCount

boolean

可选

返回filter范围内的要素个数，默认false, 即不返回个数，true时根据filter统计个数, 统计时会忽略分组设置

示例

{
    "datasourceName": "china",
    "datasetName": "road",
    "statisticinfos": [
        {
            "length": "MIN"
        }, // 获取字段length的最小值
        {
            "area": "MAX"
        },// 获取字段area的最大值
      {
            "name":"UNIQUEVALUE",
            "limit": 10
        } // 获取name的唯一值，limit设置的获取个数
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//data/statistic' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasourceName": "china",
    "datasetName": "road",
    "statisticinfos": [
        {
            "length": "MIN"
        }, // 获取字段length的最小值
        {
            "area": "MAX"
        },// 获取字段area的最大值
      {
            "name":"UNIQUEVALUE",
            "limit": 10
        } // 获取name的唯一值，limit设置的获取个数
    ]
}'

返回响应

🟢200成功

application/json

Body

resultcode

string

必需

示例

示例 1返回结果示例2返回结果示例3：只返回要素个数

{
    "resultcode": "success",
    "result": [
        {
            "group": "",
            "statistic": [
                {
                    "TBMJ": {
                        "mode": "MIN",
                        "result": 944.32
                    }
                },
                {
                    "TBDLMJ": {
                        "mode": "MAX",
                        "result": 720627.49
                    }
                }
            ]
        }
    ]
}

修改于 2024-12-02 06:57:00

wfs-transaction-delete

影像数据集波段信息统计(bandstatistic)