Python ArcGIS Item.publish用法及代碼示例

本文簡要介紹 python 語言中 arcgis.gis.Item.publish 的用法。

用法:

publish(publish_parameters=None, address_fields=None, output_type=None, overwrite=False, file_type=None, build_initial_cache=False, item_id=None, geocode_service=None)

返回：

與已發布的 Web 圖層對應的 Item 對象。

publishes 方法用於發布基於現有源項目(此項目)的托管服務。然後，發布者可以創建要素、平鋪Map、矢量平鋪和場景服務。可以從各種類型的輸入文件創建要素服務，包括

1. csv files

2. shapefiles

3. service definition files

4. feature collection files

5. file geodatabase files

包含位置字段(即地址字段或 XY 字段)的 CSV 文件在發布過程中在空間上啟用。 Shapefile 和文件地理數據庫應打包為 *.zip 文件。

可以從服務定義 (*.sd) 文件、切片包和現有要素服務創建切片Map服務。

可以從矢量切片包 (*.vtpk) 文件創建矢量切片服務。

可以從場景圖層包(*.spk、*.slpk)文件創建場景服務。

服務定義在ArcGIS Pro 或ArcGIS Desktop 中編寫，包含Map的製圖定義及其打包數據以及要創建的geo-service 的定義。

注意：

如果您從同一數據項發布了多個托管要素圖層，ArcGIS 不允許覆蓋。

注意：

ArcGIS for Enterprise for Kubernetes 不支持發布 ArcMap 生成的服務定義文件。

Parameter	Description
publish_parameters	可選字典。包含發布說明和自定義。不能與覆蓋結合。有關詳細信息，請參閱ArcGIS REST API 中的Publish Item。
address_fields	可選字典。包含 df 列到地址字段的映射，
output_type	可選字符串。僅在要素服務發布為切片服務時使用。
overwrite	可選的布爾值。如果為 True，則托管要素服務將被覆蓋。僅在 ArcGIS Enterprise 10.5+ 和 ArcGIS Online 中可用。
file_type	可選字符串。某些格式不會自動檢測，發生這種情況時，可以指定file_type：serviceDefinition、shapefile、csv、excel、tilePackage、featureService、featureCollection、fileGeodatabase、geojson、scenepackage、vectortilepackage、imageCollection、mapService 和 sqliteGeodatabase 是有效條目.這是一個可選參數。
build_initial_cache	可選的布爾值。布爾值(默認為 False)，如果為真且適用於file_type，則該值將為服務構建緩存。
item_id	可選字符串。在ArcGIS Enterprise 10.8.1+ 中可用。在ArcGIS Online 中不可用。此參數允許在創建期間指定所需的項目 ID，這對於克隆和自動內容創建方案很有用。指定的 id 必須是 32 個字符的 GUID 字符串，沒有任何特殊字符。 如果 item_id 已被使用，則會在 publish 過程中引發錯誤。
geocode_service	可選的地理編碼器。發布數據表時，可以提供可選的 Geocoder 以指定哪些服務對信息進行地理編碼。如果沒有給出地理編碼器，則使用第一個注冊的Geocoder。

# Publishing a Hosted Table Example

>>> csv_item = gis.content.get('<csv item id>')
>>> analyzed = gis.content.analyze(item=csv_item)
>>> publish_parameters = analyzed['publishParameters']
>>> publish_parameters['name'] = 'AVeryUniqueName' # this needs to be updated
>>> publish_parameters['locationType'] = None # this makes it a hosted table
>>> published_item = csv_item.publish(publish_parameters)

# Publishing a Tile Service Example

>>> item.publish(address_fields= { "CountryCode" : "Country"},
>>>               output_type="Tiles",
>>>               file_type="CSV",
>>>               item_id=9311d21a9a2047d19c0faaebd6f2cca6
>>>             )

注意：

對於publish_parameters，請參閱ArcGIS REST API 中的Publish Item 了解更多詳細信息。