Python ArcGIS ImageryLayer.identify用法及代码示例

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

用法:

identify(geometry, mosaic_rule=None, rendering_rules=None, pixel_size=None, time_extent=None, return_geometry=False, return_catalog_items=True, return_pixel_values=True, max_item_count=None, slice_id=None, process_as_multidimensional=False)

返回：

一个字典

identify 方法识别给定位置和给定马赛克规则的图像图层的内容。该位置可以是 Point 或 Polygon 或 Envelope 或 MultiPoint

注意：

镶嵌数据集和栅格数据集影像服务均支持 identify 操作。

此操作的结果包括给定镶嵌规则的镶嵌像素值、分辨率(像素大小)以及与给定几何重叠的一组目录项。单个像素值是指定位置质心处的马赛克像素值。如果有多个栅格与该位置重叠，则栅格的可见性由镶嵌规则中定义的栅格顺序确定。它还包含一组与给定几何重叠的目录项。目录项根据镶嵌规则排序。目录项目可见性列表给出了项目对整体马赛克的贡献百分比。

Parameter	Description
geometry	所需的字典/点/多边形/多点/包络。 Geometry 定义要识别的位置。 注意： 该位置可以是点、多边形、包络线或多点。 10.9.1 中添加了对信封的支持。 11.0 添加了对多点的支持。
mosaic_rule	可选字符串或字典。在定义如何对单个图像进行马赛克时指定马赛克规则。当未指定镶嵌规则时，将使用图像图层的默认镶嵌规则(如根资源中公布的：defaultMosaicMethod、mosaicOperator、sortField、sortValue)。
rendering_rules	可选字典/列表。指定如何渲染所请求的图像的渲染规则。
pixel_size	可选字符串或字典。正在识别的像素级别(或正在查看的分辨率)。句法： dictionary structure: pixel_size={point} Point simple syntax: pixel_size=’<x>,<y>’ 例子： pixel_size={“x”: 0.18, “y”: 0.18} pixel_size='0.18,0.18'
time_extent	日期时间对象或日期时间对象的可选列表。要识别的栅格的时刻或时间范围。该参数仅当图像层支持时间时才有效。
return_geometry	可选布尔值。默认值为 False。指示是否返回栅格目录项的足迹。当不需要目录项的占用空间时，将其设置为 false 以提高识别操作的响应时间。
return_catalog_items	可选布尔值。指示是否返回栅格目录项。当不需要目录项时将其设置为 false 以显著提高识别操作的性能。当设置为 false 时，不会返回目录项的几何图形和属性。
return_pixel_values	可选布尔值。指示是否返回请求几何下的所有镶嵌栅格目录项的像素值。 当请求的几何图形只需要镶嵌输出的像素值时，将其设置为 false。 此参数的默认值为 True 。 注意： 此参数是在 10.6.1 中添加的。
max_item_count	可选的整数。如果return_catalog_items参数设置为true，则该参数生效。默认行为是返回请求几何中的所有栅格目录项。否则，返回的项目数将为max_item_count中指定的值或所有符合条件的项目，以较小者为准。 示例：max_item_count = 5 注意： 该参数是在 10.6.1 中添加的。
slice_id	可选的整数。多维栅格的切片ID。将对指定切片执行识别操作。要获取切片 ID，请使用 ImageryLayer 对象上的 slices 方法。 注意： 该参数是在 10.9 中为使用 ArcObjects11 或 ArcObjectsRasterRendering 作为服务提供者的图像服务添加的。
process_as_multidimensional	可选的布尔值。指定是否将影像服务作为多维影像服务进行处理。 False - Pixel values of the specified rendering rules and mosaic rule at the specified geometry will be returned. This is the default. True - The image service is treated as a multidimensional raster, and pixel values from all slices, along with additional properties describing the slices, will be returned. 注意： 该参数是在 10.9 中为使用 ArcObjects11 或 ArcObjectsRasterRendering 作为服务提供者的图像服务添加的。

例子：

# Example Usage
img_layer = gis.content.search("my_image_service", item_type="Imagery Layer")[0].layers[0]
identified = img_layer.identify(geometry=polygon_obj,
                                pixel_size="0.18,0.18",
                                return_geometry=True,
                                return_pixel_values=False,
                                max_item_count=5,
                                slice_id=1,
                                )