要素修改(featureOperate)
PUT
/rest/services/{servicename}/data/featureoperate
更新要素。
修改注意事项：
- 如果是通过
filter进行更新的话，就是批量更新，无法支持更新geometry:- 如果下面传递的
features的类型为FeatureCollection, 则只使用第一个feature批量更新filter过滤得到的要素，传递的多余的无效 - 如果下面传递的
features的类型为Feature, 则直接使用此feature的属性批量更新filter过滤得到的要素 - 此种情况，建议直接传递类型为
Feature的内容
- 如果下面传递的
- 如果是通过
ids更新,存在如下俩种情况(下面俩种情况都会忽略其中传的kid 或 fid属性：- 如果下面传递的
features的类型为FeatureCollection, 则传递的feature数组大小与ids的数量必须相等，否则更新失败； - 如果下面传递的
features的类型为Feature, 则只会更新属性，且批量更新ids指定的要素的属性；
- 如果下面传递的
- 如果没有
ids或filter的情况下，如果下面传递的feature的属性里面没必须存在kid 或 fid，则忽略此feature，否则更新指定了具体id的要素； filter的优先级最高，ids的次之；
注意点：- 要素进行添加或修改时，feature结构需要在请求体中包含添加/修改的要素信息集合，其中单个要素信息的参考feature 结构信息。
- 对要素进行删除时（method=DELETE），通过查询过滤条件进行删除，需要在FIlter对象中包含欲删除要素的 ID 数组或SQL查询条件。
- 对于删除或更新中，filter 错误导致的失败，会返回error；对于filter正常，但是无法找到有效项的情况，返回success;
- result里面添加新的项，
successCount代表成功的项。
对应批量更新操作，要求参数
请求示例
示例1（通过`filter`更新）
{
"Request-Method":"PUT",
"datasourceName":"china",
"datasetName":"road"，
"filter":{filter object},
"features": {FeatureCollection or Feature GeoJson object},
"geoSRS": "EPSG:4490"
}
示例2（类型为`Feature`的情况）
{
"Request-Method": "put",
"datasourceName": "KQSpatialDB2403041717",
"datasetName": "XZQ",
"ids": [
9,
10
],
"features": {
"type": "Feature", // 只传递了一个要素，取其属性批量更新9和10的属性
"properties": {
"BSM": "34172112143436",
"YSDM": "1000600130",
"XZQDM": "341732324006",
"XZQMC": "测试修改9信息"
}
}
}
示例3（类型为`FeatureCollection`的情况）
{
"Request-Method": "put",
"datasourceName": "KQSpatialDB2403041717",
"datasetName": "XZQ",
"ids": [
9,
5,
4
],
"features": {
"type": "FeatureCollection",
"features": [ // 此大小与ids大小相等
{
"properties": {
"BSM": "34172112143436",
"YSDM": "1000600130",
"XZQDM": "341732324006",
"XZQMC": "测试修改9信息"
},
"geometry": {
"coordinates": [
[
[
[
39536059.092669,
3347924.042427
],
[
39536685.46414,
3348924.042427
],
[
39536685.46414,
3347597.670955
],
[
39536059.092669,
3347597.670955
],
[
39536059.092669,
3347924.042427
]
]
]
],
"type": "MultiPolygon"
}
},
{
"properties": {
"BSM": "341721121000000006",
"YSDM": "1000600105",
"XZQDM": "34172113222",
"XZQMC": "修改5测试"
}
},
{
"properties": {
"XZQMC": "修改4geomtry"
},
"geometry": {
"coordinates": [
[
[
[
39536029.092669,
3350562.042427
],
[
39537542.46414,
3350562.042427
],
[
39537542.46414,
3349404.670955
],
[
39536029.092669,
3349404.670955
],
[
39536029.092669,
3350562.042427
]
]
]
],
"type": "MultiPolygon"
}
}
]
}
}
示例4（没有`ids`或`filter`的情况）
{
"Request-Method": "put",
"datasourceName": "KQSpatialDB2403041717",
"datasetName": "XZQ",
"features": {
"type": "FeatureCollection",
"features": [
{
"properties": {
"kid": "9",
"BSM": "34172112143436",
"YSDM": "1000600130",
"XZQDM": "341732324006",
"XZQMC": "测试修改9信息"
},
"geometry": {
"coordinates": [
[
[
[
39536059.092669,
3347924.042427
],
[
39536685.46414,
3348924.042427
],
[
39536685.46414,
3347597.670955
],
[
39536059.092669,
3347597.670955
],
[
39536059.092669,
3347924.042427
]
]
]
],
"type": "MultiPolygon"
}
},
{
"properties": {
"kid": 5,
"BSM": "341721121000000006",
"YSDM": "1000600105",
"XZQDM": "34172113222",
"XZQMC": "修改5测试"
}
},
{
"properties": {
// "kid": 4, 如果这里不指定kid的话，则忽略此传递
"XZQMC": "修改4geomtry"
},
"geometry": {
"coordinates": [
[
[
[
39536029.092669,
3350562.042427
],
[
39537542.46414,
3350562.042427
],
[
39537542.46414,
3349404.670955
],
[
39536029.092669,
3349404.670955
],
[
39536029.092669,
3350562.042427
]
]
]
],
"type": "MultiPolygon"
}
}
]
}
}
请求参数
Path 参数
servicename
string
必需
Body 参数application/json
示例代码
返回响应
修改于 2024-10-09 09:30:21