Python ArcGIS Table.query_related_records用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.Table.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'}}]}]