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>