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 了解更多详细信息。