当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Python ArcGIS FeatureLayer.append用法及代码示例


本文简要介绍 python 语言中 arcgis.features.FeatureLayer.append 的用法。

用法:

append(item_id=None, upload_format='featureCollection', source_table_name=None, field_mappings=None, edits=None, source_info=None, upsert=False, skip_updates=False, use_globalids=False, update_geometry=True, append_fields=None, rollback=False, skip_inserts=None, upsert_matching_field=None, upload_id=None, *, return_messages=None, future=False)

返回:

指示成功 (True) 或失败 (False) 的布尔值。当 return_messages 为 True 时,除了布尔值之外,还将返回响应消息作为 tuple 。如果 future = True ,则结果是 Future 对象。调用 result() 获取响应。

append 方法用于更新现有托管的FeatureLayer 对象。有关更多信息,请参阅ArcGIS REST API 文档中的Append (Feature Service/Layer) 页面。

注意:

append 方法仅在 ArcGIS Online 和 ArcGIS Enterprise 10.8.1+ 中可用

Parameter

Description

item_id

可选字符串。包含源文件的门户项目的 ID。与editsUploadFormat 结合使用。

upload_format

必需的字符串。源追加数据格式。默认值为特征集合。值:‘sqlite’ | ‘shapefile’ | ‘filegdb’ | '函数集合' | ‘geojson’ | ‘csv’ | ‘excel’

source_table_name

必需的字符串。即使源数据仅包含一个表(例如,对于文件地理数据库)也需要。

# Example usage:
source_table_name=  "Building"

field_mappings

可选列表。用于将源数据映射到目标图层。语法:field_mappings=[{“name”:<”targetName”>,

“sourceName” : < “sourceName”>}, …]

# Example usage:
field_mappings=[{"name" : "CountyID",
                "sourceName" : "GEOID10"}]

edits

可选字典。仅支持特征集合 json。追加支持通过 upload_id 或 item_id 的所有格式。

source_info

可选字典。这仅在从 excel 或 csv 附加数据时才需要。 appendSourceInfo 可以是分析 csv 或 excel 文件返回的发布参数。

upsert

可选的布尔值。可选参数,指定在函数已存在时是否需要将编辑作为更新应用。默认为假。

skip_updates

可选的布尔值。仅当 upsert 为真时才使用参数。

use_globalids

可选的布尔值。指定upsert在匹配特征时是否需要使用GlobalId。

update_geometry

可选的布尔值。该参数仅在 upsert 为真时使用。如果现有要素通过 objectId 或 globalId 匹配源要素,则跳过更新几何并仅更新其属性。(由 useGlobalIds 参数指定)。

append_fields

可选列表。要附加到的目标字段列表。当 upsert=true 或 false 时支持这一点。

#Values:
["fieldName1", "fieldName2",....]

rollback

可选的布尔值。可选参数,指定在失败的情况下是否需要回滚 upsert 编辑。默认为假。

skip_inserts

仅在 upsert 为真时使用。如果值为 true,则用于跳过插入。默认值为假。

upsert_matching_field

可选字符串。通过 upsert 匹配要素时要使用的图层字段。 ObjectId、GlobalId 和任何其他具有唯一索引的字段都可以与 upsert 一起使用。该参数覆盖use_globalids;例如,即使指定 use_globalids = True,也会使用指定 upsert_matching_field。示例:upsert_matching_field=”MyfieldWithUniqueIndex”

upload_id

可选字符串。 upload() 响应中的 itemID 字段,与 appendUploadId REST API 参数相对应。此参数不应与 item_id 参数一起使用。

return_messages

可选布尔值。当设置为 True 时,将从追加返回的消息将被返回。如果 False ,则不会返回响应消息。这会将输出更改为由 (Boolean, Dictionary) 组成的元组。

future

可选布尔值。如果为 True,则将返回 future 对象,并且进程不会等待任务完成。默认为False,表示等待结果。

例子:

# Usage Example

>>> feature_layer.append(source_table_name= "Building",
                        field_mappings=[{"name" : "CountyID",
                                        "sourceName" : "GEOID10"}],
                        upsert = True,
                        append_fields = ["fieldName1", "fieldName2",...., fieldname22],
                        return_messages = False)
<True>

相关用法


注:本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 arcgis.features.FeatureLayer.append。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。