Python ArcGIS ContentManager.add用法及代码示例

本文简要介绍 python 语言中 arcgis.gis.ContentManager.add 的用法。

用法:

add(item_properties, data=None, thumbnail=None, metadata=None, owner=None, folder=None, item_id=None, **kwargs)

可选参数：

• upload_size: 可选浮点数。默认值为 1e7 字节或 ~10 MB。这是分段上传时文件大小的最小默认值。

返回：

如果添加成功则为Item，如果不成功则为 None。

add 方法通过创建 Item 将内容添加到 GIS。

注意：

内容可以是文件(例如服务定义、shapefile、CSV、图层包、文件地理数据库、地理处理包、Map包)，也可以是 URL(指向 ArcGIS 服务器服务、WMS 服务或应用程序) .

如果您要上传包或其他文件，请在数据参数中提供文件的路径或 URL。

从技术角度来看，不需要item_properties(参见下表的键：参数item_properties 的值字典选项)。但是，强烈建议提供参数 title、type、typeKeywords、tags、snippet 和 description。

Parameter	Description
item_properties	必需的字典。有关键和值，请参见下表。
data	可选字符串、io.StringIO 或 io.BytesIO。数据的路径或 URL 或 StringIO 或 BytesIO 对象的实例。
thumbnail	可选字符串。缩略图的路径或 URL。
metadata	可选字符串。元数据的路径或 URL。
owner	可选字符串。默认为登录用户。
folder	可选字符串。放置项目的文件夹的名称。
item_id	可选字符串。在ArcGIS Enterprise 10.8.1+ 中可用。在ArcGIS Online 中不可用。此参数允许在创建期间指定所需的项目 ID，这对于克隆和自动内容创建方案很有用。指定的 id 必须是 32 个字符的 GUID 字符串，没有任何特殊字符。 如果 item_id 已被使用，则会在 add 过程中引发错误。 示例：item_id=9311d21a9a2047d19c0faaebd6f2cca6

`add` 方法的可选输入参数

参数item_properties的键：值字典选项

Key	Value
type	可选字符串。表示项目的类型，有效值请参见下面的 URL 1。
dataUrl	可选字符串。存储在云存储上的数据的 URL。如果给定，则需要文件名。
filename	可选字符串。云存储上文件的名称。如果使用 dataUrl，这是必需的。
typeKeywords	可选字符串。提供所有 sub-types 的列表，请参阅下面的 URL 以获取有效值。
description	可选字符串。项目的说明。
title	可选字符串。项目的名称标签。
url	可选字符串。基于 URL 的项目的 URL。
text	可选字符串。对于基于文本的项目，例如 Feature Collections & WebMaps
tags	可选字符串。以逗号分隔值或字符串列表形式列出的标签。用于搜索项目。
snippet	可选字符串。提供项目内容的简短摘要(最多 250 个字符)。
extent	可选字符串。为 min x、min y、max x、max y 提供逗号分隔的值。
spatialReference	可选字符串。项目所在的坐标系。
accessInformation	可选字符串。有关内容来源的信息。
licenseInfo	可选字符串。有关内容的任何许可信息或限制。
culture	可选字符串。地区、国家和语言信息。
commentsEnabled	可选的布尔值。默认为 true，控制评论是允许 (true) 还是不允许 (false)。
culture	可选字符串。语言和国家信息。
overwrite	可选的布尔值。默认为 false 。控制是否可以覆盖项目。

有关详细信息，请参阅ArcGIS REST API 中的Item and Item Types。

例子：

# Usage Example

>>> gis.content.add(item_properties = {
>>>                                         "type": "Feature Collection",
>>>                                         "title" : "US Hurricane Data",
>>>                                         "tags": "Hurricanes, Natural Disasters, USA",
>>>                                         "description" : "Aggregated USA Hurricane Data for 2020",
>>>                                         "commentsEnabled" : False
>>>                                        } , owner = "User1234")