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>