Python ArcGIS FeatureLayer.query_related_records用法及代码示例

本文简要介绍 python 语言中 arcgis.features.FeatureLayer.query_related_records 的用法。

用法:

query_related_records(object_ids, relationship_id, out_fields='*', definition_expression=None, return_geometry=True, max_allowable_offset=None, geometry_precision=None, out_wkid=None, gdb_version=None, return_z=False, return_m=False, historic_moment=None, return_true_curve=False)

返回：

查询结果的字典

query_related_records 操作在FeatureLayer 资源上执行。此操作的结果是按源图层/表对象 ID 分组的要素集。每个函数集包含函数对象，其中包括用户请求的字段的值。对于相关图层，如果请求几何信息，则要素集中也会返回每个要素的几何图形。对于相关表，特征集不包括几何图形。

注意：

有关类似函数，请参阅query 方法。

Parameter	Description
object_ids	必需的字符串。需要查询的表/图层的对象ID
relationship_id	必需的字符串。需要查询的关系ID。
out_fields	必需的字符串。相关表/图层中要包含在返回的要素集中的字段列表。该列表是逗号分隔的字段名称列表。如果您在返回字段列表中指定形状字段，它将被忽略。要请求几何图形，请将 return_geometry 设置为 true。您还可以指定通配符“*” 作为该参数的值。在这种情况下，结果将包括所有字段值。
definition_expression	可选字符串。要应用于相关表/图层的定义表达式。从 objectId 列表中，仅查询符合此表达式的记录以获取相关记录。
return_geometry	可选布尔值。如果为 true，则特征集包括与每个特征关联的几何图形。默认为 true。
max_allowable_offset	可选浮点数。此选项可用于指定 max_allowable_offset 用于概括查询操作返回的几何图形。 max_allowable_offset 以 outSR 为单位。如果未指定out_wkid，则假定max_allowable_offset 以Map的空间参考为单位。
geometry_precision	可选整数。此选项可用于指定响应几何中的小数位数。
out_wkid	可选整数。返回的几何图形的空间参考。
gdb_version	可选字符串。要查询的地理数据库版本。仅当查询的图层的 isDataVersioned 属性为 true 时，此参数才适用。
return_z	可选布尔值。如果为 true，则如果要素具有 Z 值，则 Z 值将包含在结果中。否则，不返回 Z 值。默认为 false。
return_m	可选的布尔值。如果为真，如果特征具有 M 个值，则 M 个值将包含在结果中。否则，不返回 M 值。默认值为假。
historic_moment	可选整数/日期时间。历史性时刻值得查询。仅当正在查询的图层的supportsQueryWithHistoricMoment 属性设置为true 时，此参数才适用。此设置在图层资源中提供。 如果未指定historic_moment，则查询将应用于当前要素。 语法：historic_moment=<纪元时间(以毫秒为单位)>
return_true_curves	可选布尔值。可选参数，默认为 false。当设置为 true 时，返回输出几何图形中的真实曲线；否则，曲线将转换为致密的 Polyline 或 Polygon 对象。

例子：

# Usage Example:

# Query returning the related records for a feature with objectid value of 2,
# returning the values in the 6 attribute fields defined in the `field_string`
# variable:

>>> field_string = "objectid,attribute,system_name,subsystem_name,class_name,water_regime_name"
>>> rel_records = feat_lyr.query_related_records(object_ids = "2",
                                                 relationship_id = 0,
                                                 out_fields = field_string,
                                                 return_geometry=True)

>>> list(rel_records.keys())
['fields', 'relatedRecordGroups']

>>> rel_records["relatedRecordGroups"]
[{'objectId': 2,
  'relatedRecords': [{'attributes': {'objectid': 686,
     'attribute': 'L1UBHh',
     'system_name': 'Lacustrine',
     'subsystem_name': 'Limnetic',
     'class_name': 'Unconsolidated Bottom',
     'water_regime_name': 'Permanently Flooded'}}]}]