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