缓冲区分析(buffer)

POST

/rest/services/{servicename}/spatialanalysis/buffer

点、线、面要素根据输入的距离值，生成缓冲区。
请求示例

请求json示例1(数据输出到全局数据源)

{
    "dataset":
    {
        "datasourceName": "HuBeiPointData",
        "datasetName": "daolu",
    },
    "sideType":"Both",
    "radius":100.0,
    "headType":"Round",
    "cornerType":"Round",
    "dissolve":false,
    "outPutType": 1
}

请求json示例2(数据输出到当前请求指定数据源的数据集)

{
    "dataset":
    {
        "datasourceName": "HuBeiPointData",
        "datasetName": "daolu",
    },
    "sideType":"Both",
    "radius":100.0,
    "headType":"Round",
    "cornerType":"Round",
    "dissolve":false,
    "outPutType": 2,
    "outDataset":
    {
        "datasourceName": "HuBeiPointData", 
        "datasetName": "daolu_buffer"
    }
}

请求json示例3(直接返回GeoJson)

{
    "dataset":
    {
        "datasourceName": "HuBeiPointData",
        "datasetName": "daolu",
    },
    "sideType":"Both",
    "radius":100.0,
    "headType":"Round",
    "cornerType":"Round",
    "dissolve":false,
    "outPutType": 3
}

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

dataset

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 对象

sideType

enum<string>

必需

缓冲边界类型，AroundPoint 点的周围（仅点类型使用，且点类型仅支持该值） Left 前进方向的左边(说明：对于面图形，将往面外缓冲) Right < 前进方向的右边(说明：对于面图形，将往面内缓冲) Both 线的两边，面不支持

枚举值:

AroundPoint Left Right Both

headType

enum<string>

可选

缓冲末端类型，参考通用参数说明下面的相关枚举说明具体参见相关枚举说明

枚举值:

Flat Square Round

cornerType

enum<string>

可选

缓冲凸角类型，参考通用参数说明下面的相关枚举说明，具体参见相关枚举说明

枚举值:

Sharp Flat Round

pointBufferType

string

可选

点缓冲图形类型，参考通用参数说明下面的相关枚举说明。当要素集是点时，该参数有效。具体参见相关枚举说明

radius

number

必需

缓冲半径（单位：米）

outPutType

integer

必需

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

filter

object (Filter)

数据过滤条件

可选

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

dissolve

boolean

可选

是否融合，默认为false

默认值:

false

outSRS

string

可选

生成数据集的空间参考

outDataset

object (数据集连接对象)

可选

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

aysn

boolean

可选

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

returnCount

integer

可选

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

示例

{
    "dataset":
    {
        "datasourceName": "HuBeiPointData",
        "datasetName": "daolu"
    },
    "sideType":"Both",
    "radius":100.0,
    "headType":"Round",
    "cornerType":"Round",
    "dissolve":false,
    "outPutType": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/buffer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataset":
    {
        "datasourceName": "HuBeiPointData",
        "datasetName": "daolu"
    },
    "sideType":"Both",
    "radius":100.0,
    "headType":"Round",
    "cornerType":"Round",
    "dissolve":false,
    "outPutType": 1
}'

返回响应

🟢200成功

application/json

Body

resultcode

string

必需

result

string

必需

示例

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

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

修改于 2025-03-14 06:19:35

栅格直方图(rasterHistogram)

非对称缓冲区分析(asymmetricBuffer)