URI

<layer_uri>/addFeatures[.<format>]

支持的方法

POST、HEAD

父资源

layer

介绍

在指定图层中添加要素。

支持的方法：

  • POST：添加要素到指定图层中。
  • HEAD：检查 addFeatures  资源是否存在，或权限是否可以访问 addFeatures  资源。

资源层次

HTTP 请求方法

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

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

POST 请求

在指定图层中添加要素。

请求参数

对 addFeatures   资源执行 POST 请求，在指定图层中添加要素，需传递参数如下：

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

要添加的要素数组。数组中每个要素的结构与 ArcGIS REST API 返回的 json 要素对象的结构相同。如：

[{

    "geometry" : {"x" : -1949.11, "y" : 10.10},  

    "attributes" : {

      "OWNER" : "XiMenchuixue",

      "VALUE" : 6666.37,

      "APPROVED" : true,

      "LASTUPDATE" : 1227663566096,

      "GlobalID":"{71100804-E229-49b8-8CDC-9B5D3EF03EDA}"

    }

  },

  {

    "geometry" : { "x" : -1941.37, "y" : 32.096 },  

    "attributes" : {

      "OWNER" : "Yegucheng",

      "VALUE" : 17316.90,

      "APPROVED" : false,

      "LASTUPDATE" : 1227666679430,

       "GlobalID":"{12B856DC-AFE4-4c02-B433-A9361ACD91CF}"

    }

  }]

 

响应结构

字段 类型 说明
id int 图层 id
addResults EditResult[] 添加要素结果集合

响应示例

对示例 addFeatures  资源：http://localhost:8090/iserver/services/data-BeijingAddress/arcgisrest/BeijingAddress/FeatureServer/0/addFeatures.json 执行 POST 请求，执行添加操作，请求体中的参数如下：

features=[{

    "attributes": {

        "序号": 100,

        "一级分类": "企业",

        "法人代码": "10110166-0",

        "名称": "京东方科技集团股份有限公司",

        "SMLIBTILEID": "1",

        "二级分类": "电子与信息",

        "区县": "朝阳区",

        "NAME": "京东方科技集团股份有限公司",

        "SMID": 177,

        "CITY": "北京市",

        "园区名称": "电子城",

        "ADDRESS": "北京市朝阳区酒仙桥路10号",

        "SMGEOPOSITION": "670680",

        "地址": "北京市朝阳区酒仙桥路10号",

        "ID": 1240,

        "SMGEOMETRYSIZE": "20",

        "SMY": "4862514.842817815",

        "城市": "北京市",

        "SMX": "1.2967731461281551E7",

        "SMUSERID": "0",

        "COUNTY": "朝阳区"

    },

    "geometry": {

        "x": 1.2967731461281551E7,

        "y": 4862514.842817815,

        "spatialReference": null

    }

}]

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

{

    "id": -1,

    "addResults": [{

        "success": true,

        "globalId": "176",

        "error": null,

        "objectId": 176

    }],

    "updateResults": null,

    "deleteResults": null

}

HEAD 请求

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

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

请参见