URI

<layer_uri>/applyedits[.<format>]

支持的方法

POSTHEAD

父资源

layer

介绍

此资源可以编辑指定图层中的要素,支持添加、更新和删除等操作。操作返回编辑结果,结果按编辑类型(addResults,updateResults和deleteResults)分组。

支持的方法:

  • POST:按照给定参数编辑要素 。
  • HEAD:检查 applyEdits 资源是否存在,或权限是否可以访问 applyEdits 资源。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/{datasourceName}/FeatureServer/{layerID}/applyedits.json

POST 请求

按照给定参数编辑要素 。

请求参数

对 applyEdits  资源执行 POST 请求,按照给定参数编辑要素,需传递参数如下:

名称

类型

含义

adds

String

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

adds=[

  {

    "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}"

    }

  }

]

updates

String

要更新的要素数组。数组中每个要素的结构与 ArcGIS REST API 返回的 json 功能对象的结构相同,并包含 globalId。如:

updates=

[

  {

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

    "attributes" : {

      "OBJECTID" : 37,

      "OWNER" : "XiMenchuixue",

      "VALUE" : 94820.37,

      "APPROVED" : true,

      "LASTUPDATE" : 1227667627940

    }

  },

  {

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

    "attributes" : {

      "OBJECTID" : 462,

      "OWNER" : "Yegucheng",

      "VALUE" : 17165.90,

      "APPROVED" : false,

      "LASTUPDATE" : 9269154204840

    }

  }

]

deletes

String

要删除的要素/记录的对象ID。如:

deletes=31, 466

deletes=[31,466]

响应结构

字段

类型

说明

id

int

图层 id

addResults

EditResult[]

添加要素结果集合

updateResults

EditResult[]

更新要素结果集合

deleteResults

EditResult[]

删除要素结果集合

响应示例

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

adds=[

  {

    "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}"

    }

  }

]

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

{

    "id": -1,

    "addResults": [

        {

            "success": true,

            "globalId": "13516",

            "error": null,

            "objectId": 13516

        },

        {

            "success": true,

            "globalId": "13517",

            "error": null,

            "objectId": 13517

        }

    ],

    "updateResults": [],

    "deleteResults": []

}

HEAD 请求

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

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

请参见