URI

<layer_uri>/deleteFeatures[.<format>]

支持的方法

POSTHEAD

父资源

layer

介绍

在指定图层中删除要素。

支持的方法:

  • POST:删除指定图层中的要素。
  • HEAD:检查 deleteFeatures 资源是否存在,或权限是否可以访问 deleteFeatures 资源。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,{component}是服务组件名,{datasourceName}是数据源名,{layerID} 是图层 ID 号。

http://supermapiserver:8090/iserver/services/{component}/arcgisrest/{datasourceName}/FeatureServer/{layerID}/deleteFeatures.json

POST 请求

请求参数

对 deleteFeatures 资源执行 POST 请求,在指定图层中删除要素,需传递参数如下:

名称 类型 含义
f String 响应格式,支持 json、pjson
where String

查询过滤器的 WHERE 子句。如:

where=CITY_NAME = 'Barrington'。

objectIds int

要查询的层的对象ID。如:

objectIds=37, 462

geometry String

用作空间过滤器的几何对象。几何的结构与 ArcGIS REST API 返回的 JSON 几何对象的结构相同。除了 JSON 结构外,对于 envelope 和 point,还可以使用逗号分隔语法来指定几何对象。如:

geometry={xmin: -112, ymin: 32.6, xmax: -91.11, ymax: 41}

geometry=-112,32.6,-91.11,41

geometry=-112,32.6

geometryType ArcGISGeometryType 由 geometry 参数指定的几何类型。几何类型可以是esriGeometryPoint 、esriGeometryMultipoint 、esriGeometryPolyline、 esriGeometryPolygon、esriGeometryEnvelope。默认几何类型是 esriGeometryEnvelope。
inSR String 输入几何对象的空间参考。
spatialRel String

执行查询时要应用于输入几何对象的空间关系。支持的空间关系包括 esriSpatialRelIntersects、esriSpatialRelContains、esriSpatialRelCrosses、esriSpatialRelEnvelopeIntersects、esriSpatialRelIndexIntersects、esriSpatialRelOverlaps、esriSpatialRelTouches、esriSpatialRelWithin、esriSpatialRelRelation。默认的空间关系是 esriSpatialRelIntersects。

响应结构

对  deleteFeatures 资源执行 POST 请求删除指定图层的要素,返回的删除结果的结构如下:

字段 类型 说明
id int 图层 id
deleteResults EditResult[] 删除要素结果集合

响应示例

对示例 deleteFeatures 资源:http://localhost:8090/iserver/services/data-BeijingAddress/arcgisrest/BeijingAddress/FeatureServer/0/deleteFeatures 执行 POST 请求,执行删除操作,请求体中的参数如下:

[

  {

   objectIds=37, 462  

   where=SMID > 10000

   }

]

则返回的 pjson 格式的操作结果表述如下:

{

    "id": -1,

    "addResults": null,

    "updateResults": null,

    "deleteResults": [

        {

            "success": true,

            "globalId": "3003",

            "error": null,

            "objectId": 3003

        },

        {

            "success": true,

            "globalId": "3004",

            "error": null,

            "objectId": 3004

        },

        {

            "success": true,

            "globalId": "3005",

            "error": null,

            "objectId": 3005

        },

        {

            "success": true,

            "globalId": "3006",

            "error": null,

            "objectId": 3006

        },

        {

            "success": true,

            "globalId": "3007",

            "error": null,

            "objectId": 3007

        },

        {

            "success": true,

            "globalId": "3008",

            "error": null,

            "objectId": 3008

        },

        {

            "success": true,

            "globalId": "3009",

            "error": null,

            "objectId": 3009

        },

        {

            "success": true,

            "globalId": "3010",

            "error": null,

            "objectId": 3010

        },

        {

            "success": true,

            "globalId": "3011",

            "error": null,

            "objectId": 3011

        },

        {

            "success": true,

            "globalId": "3012",

            "error": null,

            "objectId": 3012

        },

        {

            "success": true,

            "globalId": "3013",

            "error": null,

            "objectId": 3013

        },

        {

            "success": true,

            "globalId": "3014",

            "error": null,

            "objectId": 3014

        },

        {

            "success": true,

            "globalId": "3015",

            "error": null,

            "objectId": 3015

        },

        {

            "success": true,

            "globalId": "3016",

            "error": null,

            "objectId": 3016

        },

        {

            "success": true,

            "globalId": "3017",

            "error": null,

            "objectId": 3017

        },

        {

            "success": true,

            "globalId": "3018",

            "error": null,

            "objectId": 3018

        },

        {

            "success": true,

            "globalId": "3019",

            "error": null,

            "objectId": 3019

        },

        {

            "success": true,

            "globalId": "3020",

            "error": null,

            "objectId": 3020

        },

        {

            "success": true,

            "globalId": "3021",

            "error": null,

            "objectId": 3021

        },

        {

            "success": true,

            "globalId": "3022",

            "error": null,

            "objectId": 3022

        },

        {

            "success": true,

            "globalId": "3023",

            "error": null,

            "objectId": 3023

        },

        {

            "success": true,

            "globalId": "3024",

            "error": null,

            "objectId": 3024

        },

        {

            "success": true,

            "globalId": "3025",

            "error": null,

            "objectId": 3025

        },

        {

            "success": true,

            "globalId": "3026",

            "error": null,

            "objectId": 3026

        },

        {

            "success": true,

            "globalId": "3027",

            "error": null,

            "objectId": 3027

        },

        {

            "success": true,

            "globalId": "3028",

            "error": null,

            "objectId": 3028

        },

        {

            "success": true,

            "globalId": "3029",

            "error": null,

            "objectId": 3029

        },

        {

            "success": true,

            "globalId": "3030",

            "error": null,

            "objectId": 3030

        },

        {

            "success": true,

            "globalId": "3031",

            "error": null,

            "objectId": 3031

        },

        {

            "success": true,

            "globalId": "3032",

            "error": null,

            "objectId": 3032

        },

        {

            "success": true,

            "globalId": "3033",

            "error": null,

            "objectId": 3033

        },

        {

            "success": true,

            "globalId": "3034",

            "error": null,

            "objectId": 3034

        },

        {

            "success": true,

            "globalId": "3035",

            "error": null,

            "objectId": 3035

        },

        {

            "success": true,

            "globalId": "3036",

            "error": null,

            "objectId": 3036

        },

        {

            "success": true,

            "globalId": "3037",

            "error": null,

            "objectId": 3037

        },

        {

            "success": true,

            "globalId": "3038",

            "error": null,

            "objectId": 3038

        },

        {

            "success": true,

            "globalId": "3039",

            "error": null,

            "objectId": 3039

        },

        {

            "success": true,

            "globalId": "3040",

            "error": null,

            "objectId": 3040

        },

        {

            "success": true,

            "globalId": "3041",

            "error": null,

            "objectId": 3041

        },

        {

            "success": true,

            "globalId": "3042",

            "error": null,

            "objectId": 3042

        },

        {

            "success": true,

            "globalId": "3043",

            "error": null,

            "objectId": 3043

        },

        {

            "success": true,

            "globalId": "3044",

            "error": null,

            "objectId": 3044

        },

        {

            "success": true,

            "globalId": "3045",

            "error": null,

            "objectId": 3045

        },

        {

            "success": true,

            "globalId": "3046",

            "error": null,

            "objectId": 3046

        },

        {

            "success": true,

            "globalId": "3047",

            "error": null,

            "objectId": 3047

        },

        {

            "success": true,

            "globalId": "3048",

            "error": null,

            "objectId": 3048

        },

        {

            "success": true,

            "globalId": "3049",

            "error": null,

            "objectId": 3049

        },

        {

            "success": true,

            "globalId": "3050",

            "error": null,

            "objectId": 3050

        },

        {

            "success": true,

            "globalId": "3051",

            "error": null,

            "objectId": 3051

        },

        {

            "success": true,

            "globalId": "3052",

            "error": null,

            "objectId": 3052

        },

        {

            "success": true,

            "globalId": "3053",

            "error": null,

            "objectId": 3053

        },

        {

            "success": true,

            "globalId": "3054",

            "error": null,

            "objectId": 3054

        },

        {

            "success": true,

            "globalId": "3055",

            "error": null,

            "objectId": 3055

        },

        {

            "success": true,

            "globalId": "3056",

            "error": null,

            "objectId": 3056

        },

        {

            "success": true,

            "globalId": "3057",

            "error": null,

            "objectId": 3057

        },

        {

            "success": true,

            "globalId": "3058",

            "error": null,

            "objectId": 3058

        },

        {

            "success": true,

            "globalId": "3059",

            "error": null,

            "objectId": 3059

        },

        {

            "success": true,

            "globalId": "3060",

            "error": null,

            "objectId": 3060

        },

        {

            "success": true,

            "globalId": "3061",

            "error": null,

......

 

    ]

  }

0

HEAD 请求

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

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

请参见