叠置分析(overlay)

POST

/rest/services/{servicename}/spatialanalysis/overlay

对两个输入数据集进行各种叠置操作，常见的叠置分析包括相交、擦除、更新、联合、交集取反等。

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

TopologyEnv

object

可选

拓扑环境变量，可选，不设置时，使用系统默认值

pointLimit

number

可选

共点容差值(注意：单位为米)

lineLimit

number

可选

短线容差值(注意：单位为米)

areaLimit

number

可选

微小面积容差(注意：单位为平方米)

boolLimit

number

必需

布尔操作共点容差(注意：单位为米)

srcDataset

object (数据集连接对象)

必需

源数据，具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

layerid

string

可选

图层id，通过地图服务配置方式发布下可用，优先级最高

datasourceName

string

数据源名称

可选

datasourceID

string

可选

数据源ID ，和datasourceName功能相同，用于确定数据源。二选一，优先级高于datasourceName。

datasetName

string

数据集名称

可选

datasetID

string

可选

每个数据集对应一个唯一标识ID，可替换数据源名称+数据集名称，确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高，规则参考数据服务中的id规则。

geometry

string

可选

Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection类型的GeoJson对象具体参见 “geojson 对象” geojson 对象

operDataset

object (数据集连接对象)

必需

操作数据，具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

operateType

enum<string>

必需

布尔操作类型枚举，参考通用参数说明下面的相关枚举说明具体参见相关枚举说明

枚举值:

Union Intersect Erase Update SymmetricalDifference Clip Identity

outFields

string

必需

布尔操作结果要素属性继承方式，参考通用参数说明下面的相关枚举说明，具体参见相关枚举说明

sourceDatasetFields

array[string]

必需

源数据集中要复制的字段。如果只设置了sourceDatasetFields，未设置operateDatasetFields，outFields 值应设置为FromSource，否则outFields 值应设置为All（当源数据不是GeoJson对象时该参数有效）

operateDatasetFields

array[string]

必需

操作数据集中要复制的字段。如果只设置了operateDatasetFields，未设置sourceDatasetFields，outFields 值应设置为FromOperate，否则outFields 值应设置为All （当目标数据不是GeoJson对象时该参数有效）

outPutType

integer

必需

分析结果输出类型，
1代表输出到全局数据源；
2代表输出到当前服务指定数据源的数据集；
3代表输出"GeometryCollection"或"FeatureCollection"的GeoJson对象。

srcDatasetFilter

object

源数据过滤条件

可选

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

SpatialRel

string

可选

查询空间判断过滤类型

Fids

array[string]

可选

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

geoSRS

string

可选

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

operDatasetFilter

object

操作数据过滤条件

可选

where

string

可选

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

geometry

string

可选

subfields

string

可选

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

SpatialRel

string

可选

查询空间判断过滤类型

Fids

array[string]

可选

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

geoSRS

string

可选

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

minArea

integer

可选

面积容差（单位：平方米），叠置面积小于minArea的结果将被过滤掉。

minLength

integer

可选

长度容差（单位：米），叠置长度小于minArea的结果将被过滤掉。

outSRS

string

可选

生成数据集的空间参考

ellipsoidal

boolean

可选

是否为椭球面积，默认为false；为true时返回为outSRS空间参考下的椭球面积，为false时返回其几何面积（图形本身的面积）。

默认值:

false

resultFieldName

string

可选

重算结果图形（可能是面也可能是线）面积或长度赋值到resultFieldName指定的字段中去，如果resultFieldName字段不存在则新建字段。

outDataset

object (数据集连接对象)

可选

叠置结果保存路径。当outPutType指定为2时，该参数有效，具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

returnCount

integer

可选

要求返回结果的最大记录数**。**当outPutType指定为3时，该参数有效。如果未指定，默认值为20000。这里的20000的可配置项位于 servicetype.xml 的ServicePlugins中空间分析服务属性项的MaxReturnCount值。如果设置的值大于20000，则使用20000，否则使用用户设置的值

aysn

boolean

可选

是否异步执行，如果异步执行，直接返回任务id，通过任务状态查询返回结果。默认同步。

默认值:

false

outGeoPrecision

integer

可选

输出几何坐标的小数位数，默认8位。当outPutType指定为3时，该参数有效

bindFeature

boolean

可选

是否捆绑叠置结果要素(相同源且相同操作)，默认为true

returnMany

boolean

可选

指定源要素层或者操作要素层自身有重叠时叠置结果是否返回多个对象(重叠部分)，默认为true。

示例

{
    "srcDataset":
    {
        "datasourceName": "HuBei", 
        "datasetName": "dltb2020"
    },
    "srcDatasetFilter":
    {
        "where": "dlbm = '0201' OR dlbm = '0202'",
        "geometry": 
        {
            "type":"Polygon",
            "coordinates":[[[39534640.8139820099,3345625.0066242237],[39534640.8139820099,3348795.9912395477],
                            [39538068.2273349762,3348795.9912395477],[39538068.2273349762,3345625.0066242237],[39534640.8139820099,3345625.0066242237]]]
        },
        "SpatialRel": "Intersects"
    },
    "operDataset":
    {
        "datasourceName": "HuBei",
        "datasetName": "dltb2021"
    },
    "operDatasetFilter":
    {
        "geometry": 
        {
            "type":"Polygon",
            "coordinates":[[[39534640.8139820099,3345625.0066242237],[39534640.8139820099,3348795.9912395477],
                            [39538068.2273349762,3348795.9912395477],[39538068.2273349762,3345625.0066242237],[39534640.8139820099,3345625.0066242237]]]
        },
        "SpatialRel": "Intersects"
    },
    "operateType":"Intersect",
    "outFields":"FromSource",
    "outPutType": 2,
    "outDataset":
    {
        "datasourceName": "HuBei",
        "datasetName": "result"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/overlay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "srcDataset":
    {
        "datasourceName": "HuBei", 
        "datasetName": "dltb2020"
    },
    "srcDatasetFilter":
    {
        "where": "dlbm = '\''0201'\'' OR dlbm = '\''0202'\''",
        "geometry": 
        {
            "type":"Polygon",
            "coordinates":[[[39534640.8139820099,3345625.0066242237],[39534640.8139820099,3348795.9912395477],
                            [39538068.2273349762,3348795.9912395477],[39538068.2273349762,3345625.0066242237],[39534640.8139820099,3345625.0066242237]]]
        },
        "SpatialRel": "Intersects"
    },
    "operDataset":
    {
        "datasourceName": "HuBei",
        "datasetName": "dltb2021"
    },
    "operDatasetFilter":
    {
        "geometry": 
        {
            "type":"Polygon",
            "coordinates":[[[39534640.8139820099,3345625.0066242237],[39534640.8139820099,3348795.9912395477],
                            [39538068.2273349762,3348795.9912395477],[39538068.2273349762,3345625.0066242237],[39534640.8139820099,3345625.0066242237]]]
        },
        "SpatialRel": "Intersects"
    },
    "operateType":"Intersect",
    "outFields":"FromSource",
    "outPutType": 2,
    "outDataset":
    {
        "datasourceName": "HuBei",
        "datasetName": "result"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例outPutType指定为1时成功示例outPutType指定为2时成功示例outPutType指定为3时成功示例异步

{
    "resultcode": "success",
    "time": 0.343,
    "result": {
        "datasetName": "s_overlay_48ba8fa1144640939a944f75e1682265"
    }
}

修改于 2025-03-14 06:39:42

多重缓冲(multiBuffer)

空间关系分析(relation)