Python ArcGIS upload_imagery_to_agol_userstore用法及代码示例

本文简要介绍 python 语言中 arcgis.raster.utils.upload_imagery_to_agol_userstore 的用法。

用法:

arcgis.raster.utils.upload_imagery_to_agol_userstore(files, direct_access_url=None, auto_renew=True, upload_properties=None, *, gis=None)

返回：

文件路径列表。

在ArcGIS Online 上将文件上传到用户的栅格存储并返回 url 列表。

然后可以将 url 列表与 copy_raster() 或 create_image_collection() 方法一起使用，在 ArcGIS Online 上创建图像层。

要使此函数正常工作，需要预先安装适用于 Python 的 Azure 库包(Azure SDK for Python - azure-storage-blob: 12.1<= version <=12.9)。参考https://docs.microsoft.com/en-us/azure/storage/blobs/storage-quickstart-blobs-python#install-the-package

Parameter	Description
files	必需的。它可以是需要上传的文件夹、文件列表或单个文件。
direct_access_url	可选字符串。使用 generate_direct_access_url() 生成的直接访问 url。如果未指定，该函数将在内部生成直接访问 url，有效期为 1440 分钟。
auto_renew	可选的布尔值。如果设置为 True，函数将继续上传，直到通过自动更新直接访问 url 上传整个数据。 (默认为真)
upload_properties	可选字典。 upload_properties可以用来控制具体的上传参数。 可用选项： maxUploadConcurrency：可选整数。用于大型上传的最大并行连接数(当单个文件/blob 大小超过 64MB 时)。这是max_concurrency的参数BlobClient.upload_blob()方法。 (默认为 6) maxWorkerThreads：可选整数。上传多个文件时异步执行的最大线程数。这是max_workers的参数ThreadPoolExecutor()类。 (默认为无) displayProgress：可选布尔值。如果设置为 True，将显示一个进度条，用于跟踪上传到用户光栅存储的进度。 (默认为False) 例子： {“maxUploadConcurrency”:8, “maxWorkerThreads”:20, “displayProgress”:True}
gis	仅关键字参数。可选 GIS 。运行此函数的 GIS。如果未指定，则使用活动 GIS。

例子：

# Usage Example: Generates an expirable direct access url and uploads files to the user's raster store.

sas_url = generate_direct_access_url(expiration=180, gis=gis)

uploaded_imagery = upload_imagery_to_agol_userstore(files=r"/path/to/data", 
                                                    direct_access_url=sas_url,
                                                    upload_properties={"displayProgress":True},
                                                    gis=gis
                                                    )

# Following snippet executes the copy_raster() function on the uploaded imagery to create imagery layer item on ArcGIS Online.

copy_raster_op = copy_raster(input_raster=uploaded_imagery,
                             raster_type_name="Raster Dataset",
                             output_name="output_layer",
                             gis=gis)