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

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

用法:

find(search_text, layers, contains=True, search_fields=None, sr=None, layer_defs=None, return_geometry=True, max_offset=None, precision=None, 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)

返回：

一個字典

find 方法執行Map服務find 操作。

Parameter	Description
search_text	必需的字符串。搜索字符串。這是在用戶指定的圖層和字段中搜索的文本。
layers	可選字符串。要對其執行識別操作的層。有三種方法可以指定要識別的層： top：僅位於指定位置的最頂層。 visible：指定位置的所有可見圖層。 all：指定位置的所有圖層。
contains	可選布爾值。如果為 false，則該操作將搜索 search_text 字符串的精確匹配項。精確匹配區分大小寫。否則，它將搜索包含所提供的 search_text 的值。此搜索不區分大小寫。默認為 true。
search_fields	可選字符串。要查看的字段名稱列表。
sr	可選的字典、字符串或 SpatialReference。輸入和輸出幾何圖形的空間參考以及 map_extent 的眾所周知的 ID。如果未指定 sr，則假定幾何圖形和 map_extent 位於Map的空間參考中，並且輸出幾何圖形也位於Map的空間參考中。
layer_defs	可選字典。允許您通過指定圖層的定義表達式來過濾導出Map中各個圖層的要素。將始終遵循隨服務發布的圖層的定義表達式。
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，結果中的值將不會被格式化，即數字將按原樣返回，日期將作為紀元值返回。
return_field_name	可選布爾值。如果為 true，將返回字段名稱而不是字段別名。
transformations	可選列表。當 sr 與Map服務的空間參考不同時，使用此參數可對Map應用一個或多個基準麵變換。它是一個變換元素的數組。
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")
>>> search_results = map_image_item.find(search_text = "Hurricane Data",
                        contains = True,
                        layers = "top",
                        return_geometry = False,
                        max_offset = 100,
                        return_z = True,
                        return_m = False,
                        )
>>> type(search_results)
<Dictionary>