Python ArcGIS MapImageLayer.identify用法及代碼示例

本文簡要介紹 python 語言中 arcgis.mapping.MapImageLayer.identify 的用法。

用法:

identify(geometry, map_extent, image_display=None, geometry_type='Point', sr=None, layer_defs=None, time_value=None, time_options=None, layers='all', tolerance=None, return_geometry=True, max_offset=None, precision=4, dynamic_layers=None, return_z=False, return_m=False, gdb_version=None, return_unformatted=False, return_field_name=False, transformations=None, map_range_values=None, layer_range_values=None, layer_parameters=None, **kwargs)

返回：

一個字典

identify 操作在Map服務資源上執行以發現地理位置的特征。此操作的結果是識別結果資源。

注意：

每個識別的結果包括其 name 、 layer ID 、 layer name 、 geometry 、 geometry type 以及該結果的其他屬性作為 name-value 對。

Parameter	Description
geometry	必需的 Geometry 或列表。要識別的幾何圖形。幾何圖形的類型由geometryType 參數指定。幾何結構與API返回的JSON幾何對象的結構相同(參見Geometry Objects)。除了 JSON 結構之外，對於點和包絡線，您還可以使用更簡單的逗號分隔語法來指定幾何形狀。
geometry_type	必需的字符串。由幾何參數指定的幾何類型。幾何類型可以是點、線、多邊形或包絡線。值： “Point” | “Multipoint” | “Polyline” | “Polygon” | “Envelope”
map_extent	必需的字符串。當前正在查看的Map的範圍或邊界框。
sr	可選的字典、字符串或 SpatialReference。輸入和輸出幾何圖形的空間參考以及 map_extent 的眾所周知的 ID。如果未指定 sr，則假定幾何圖形和 map_extent 位於Map的空間參考中，並且輸出幾何圖形也位於Map的空間參考中。
layer_defs	可選字典。允許您通過指定圖層的定義表達式來過濾導出Map中各個圖層的要素。將始終遵循隨服務發布的圖層的定義表達式。
time_value	可選列表。待識別特征的時刻或時間範圍。
time_options	可選字典。每層的時間選項。用戶可以指定圖層是否使用時間參數指定的時間範圍、是否累積繪製圖層要素以及圖層的時間偏移量。
layers	可選字符串。要對其執行識別操作的層。有三種方法可以指定要識別的層： top：僅指定位置的最頂層。 visible：指定位置的所有可見圖層。 all：指定位置的所有圖層。
tolerance	可選整數。距指定幾何圖形的屏幕像素距離(應在該距離內執行 identify 操作)。容差值是一個整數。
image_display	可選字符串。當前正在查看的Map的屏幕圖像顯示參數(寬度、高度和DPI)。服務器使用mapExtent和image_display參數來確定當前範圍內可見的圖層。它們還用於根據屏幕像素的容差計算Map上的搜索距離。 用法: <width>, <height>, <dpi>
return_geometry	可選布爾值。如果為 true，結果集將包含與每個結果關聯的幾何圖形。默認為 true。
max_offset	可選整數。此選項可用於指定用於概括識別操作返回的幾何圖形的最大允許偏移量。
precision	可選整數。此選項可用於指定識別操作返回的響應幾何圖形中的小數位數。這僅適用於 X 和 Y 值(不適用於 m 或 z-values)。
dynamic_layers	可選字典。使用dynamicLayers屬性對圖層重新排序並更改圖層數據源。動態圖層還可用於添加未在用於創建Map服務的Map中定義的新圖層。新圖層的源應指向創建Map服務時定義的已注冊工作空間之一。 DynamicLayers 數組的順序定義了圖層繪製順序。 DynamicLayers 的第一個元素堆疊在所有其他層的頂部。定義動態層時，需要源。
return_z	可選布爾值。如果為 true，則如果要素具有 Z 值，則 Z 值將包含在結果中。否則，不返回 Z 值。默認為 false。
return_m	可選布爾值。如果為 true，則如果要素具有 M 值，則 M 值將包含在結果中。否則，不返回 M 值。默認為 false。
gdb_version	可選字符串。切換Map圖層以指向備用地理數據庫版本。
return_unformatted	可選布爾值。如果為 true，結果中的值將不會被格式化，即數字將按原樣返回，日期將作為紀元值返回。默認值為 False。
return_field_name	可選布爾值。默認值為 False。如果為 true，將返回字段名稱而不是字段別名。
transformations	可選列表。當 sr 與Map服務的空間參考不同時，使用此參數可將一個或多個基準麵變換應用於Map。它是一個變換元素的數組。此處指定的轉換用於將Map服務中的圖層中的要素投影到 sr。
map_range_values	可選的字典列表。允許從指定範圍瞬間或範圍內的所有圖層過濾導出Map中的要素。
layer_range_values	可選詞典。允許過濾指定範圍瞬時或範圍內的每個單獨圖層的要素。
layer_parameters	可選的字典列表。允許通過為這些圖層的預先創建的參數化過濾器數組指定值來過濾導出Map中各個圖層的要素。當未為請求中的任何參數指定值時，將使用在創作期間分配的默認值。

例子：

# USAGE EXAMPLE

>>> from arcgis.mapping import MapImageLayer
>>> from arcgis.gis import GIS

# connect to your GIS and get the web map item
>>> gis = GIS(url, username, password)

>>> map_image_item = gis.content.get("2aaddab96684405880d27f5261125061")
>>> identified = map_image_item.identify(geometry = geom1,
                            geometry_type = "Multipoint",
                            image_display = "width",
                            return_geometry =True,
                            return_z = True,
                            retrun_m = True,
                            return_field_name = True,
                            )
>>> type(identified)
<Dictionary>