buffer

URI

<geometryService_uri>/buffer[.<format>]

支持的方法

GET、POST、HEAD

父资源

geometryService

介绍

缓冲区分析资源表示在几何服务资源中进行的缓冲区分析操作，它返回的结果是对输入的几何数组中的几何图形在指定距离处生成的缓冲多边形。

支持的方法：

GET：获取缓冲多边形。
POST：根据给定条件，创建缓冲多边形。
HEAD：检查 buffer 资源是否存在，或权限是否可以访问 buffer 资源。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 json 输出格式为例加以说明，其中，supermapiserver 是服务器名， {component}是服务组件名。

http://supermapiserver:8090/iserver/services/{component}/arcgisrest/Geometry/GeometryServer/buffer.json

GET 请求

获取几何数组内几何图形的缓冲多边形。

请求参数

名称	类型	含义
f	String	响应格式，支持 json、pjson
geometries	String	【必设参数】需要进行缓冲操作的几何数组。几何的空间参考由inSR指定。例如： { "geometryType" : "esriGeometryPoint", "geometries" : [ {"x" : -104.5, "y" : 34.74}, {"x" : -63.53, "y" : 10.23} ] }
inSR	String	【必设参数】输入的几何图形的空间参考或空间参考 JSON 对象的 ID。有效的 ID 请参见投影坐标系对照表和地理坐标系对照表。
outSR	String	可选参数。返回的几何图形的空间参考或空间参考 JSON 对象的 ID。有效的 ID 请参见投影坐标系对照表和地理坐标系对照表。
bufferSR	String	可选参数。生成的缓冲几何图形的空间参考或空间参考JSON对象的ID。有效的 ID 请参见投影坐标系对照表和地理坐标系对照表。
distances	String	【必设参数】输入的几何图形的缓冲距离。距离单位由 unit 指定。
unionResults	boolean	可选参数。如果为 true，则将在给定距离缓冲的所有几何图形合并为一个（或多个）多边形，并将合并的几何图形以数组形式输出。默认为 false。
unit	int	可选参数。用于计算每个缓冲区距离的单位。如果未指定单位，则单位和 bufferSR 相同；如果未指定 bufferSR，则单位和 inSR 相同。

响应结构

对 buffer 资源执行 GET 请求，返回的是几何图形信息。

字段	类型	说明
geometryType	ArcGISGeometryType	几何图形的类型。
geometries	ArcPointNoProj[]	坐标构成的点数组。
	ArcPolylineNoProj[]	坐标构成的线数组。
	ArcPolygonNoProj[]	坐标构成的面数组。

响应示例

对 ArcGIS buffer 资源：http://supermapiserver:8090/iserver/services/geometry-vvvv/arcgisrest/Geometry/GeometryServer/buffer?geometries=-117,34&inSR=4326&outSr=4326&bufferSR=3857&distances=1000&unionResults=false&f=pjson 执行 GET 请求，返回 pjson 格式的资源表述如下:

{

"geometries": [{"rings": [[

[

-116.9910168471588,

[

-116.9917006489526,

33.99656229623727

[

-116.99364795170956,

33.993647951709555

[

-116.99656229623727,

33.9917006489526

[

-117,

33.991016847158804

[

-117.00343770376273,

33.9917006489526

[

-117.00635204829044,

33.993647951709555

[

-117.0082993510474,

33.99656229623727

[

-117.0089831528412,

[

-117.0082993510474,

34.00343770376273

[

-117.00635204829044,

34.006352048290445

[

-117.00343770376273,

34.0082993510474

[

-117,

34.008983152841196

[

-116.99656229623727,

34.0082993510474

[

-116.99364795170956,

34.006352048290445

[

-116.9917006489526,

34.00343770376273

[

-116.9910168471588,

]

]]}],

"geometryType": "esriGeometryPolygon"

}

POST 请求

跟 GET 请求结构类似。

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 buffer 资源是否存在，或者客户端是否有权限访问 buffer 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 buffer 资源是否支持<format>格式的表述。

URI