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