AE开发实现Spatial Join Analysis

时间：2021-02-13 10:17:14
总体网上资料不多，包括esri帮助文档都写的很简单，没有各个string参数如match_option之类的可以输入的string限制，导致在摸索中gp.Execute时报错n回。
结合网上搜集资料及个人试验，总结下各个参数的用法。
 
代码在vs2010+AO10.1下测试通过。
简单代码示例： 
public void SpatialJoin()
        {
            // Spatial join 功能
            Geoprocessor gp = new Geoprocessor();
            gp.OverwriteOutput = true;
            SpatialJoin pSpatialJoin = new SpatialJoin();
            pSpatialJoin.target_features = @"E:\b.shp";//目标图层，可以是shp等文件路径或者featureclass之类的
            pSpatialJoin.join_features = @"E:\a.shp";  //join的图层
            pSpatialJoin.out_feature_class = @"E:\a_SpatialJoin.shp"; //输出图层文件，存在不存在无所谓
            pSpatialJoin.join_operation = "JOIN_ONE_TO_ONE"; //JOIN_ONE_TO_ONE或者JOIN_ONE_TO_ONE
            pSpatialJoin.match_option = "within"; //CONTAINS、within等空间关系
            pSpatialJoin.join_type = "KEEP_ALL";//KEEP_ALL或者KEEP_COMMON 
            
            gp.Execute(pSpatialJoin, null);
        }
 

语法

SpatialJoin_analysis (target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name})

参数

说明

数据类型

target_features

只要找到指定的空间关系（或匹配选项），就会将“连接要素”的属性传递到“目标要素”。“目标要素”可以是ArcGIS 支持的任意空间数据源。

Feature Layer

join_features

只要找到指定的空间关系（或匹配选项），就会将“连接要素”的属性传递到“目标要素”。“连接要素”可以是ArcGIS 支持的任意空间数据源。

Feature Layer

out_feature_class

该新要素类包含连接到“目标要素”的“连接要素”的属性。

Feature Class

join_operation

(可选)

用于在找到多个与同一“目标要素”存在相同空间关系的“连接要素”时确定输出要素类中“目标要素”和“连接要素”的连接方式。例如，如果在两个独立的面“连接要素”中找到了同一个点“目标要素”，则可以选择使用“字段映射”合并规则 (JOIN_ONE_TO_ONE) 对两个面的属性进行聚合，也可以选择在输出中存在两个“目标要素”实例，分别包含两个面的属性 (JOIN_ONE_TO_MANY)。

  • JOIN_ONE_TO_ONE —如果找到多个与同一“目标要素”存在相同空间关系的“连接要素”，将使用“字段映射”合并规则对多个“连接要素”中的属性进行聚合。例如，如果在两个独立的面“连接要素”中找到了同一个点“目标要素”，将对这两个面的属性进行聚合，然后将其传递到输出要素类。如果一个面的属性值为 3，另一个面的属性值为 7，且指定了“总和”合并规则，则输出要素类中的聚合值将为10。JOIN_ONE_TO_ONE 为默认选项。
  • JOIN_ONE_TO_MANY —如果找到多个与同一“目标要素”存在相同空间关系的“连接要素”，输出要素类将包含多个“目标要素”实例。例如，如果在两个独立的面“连接要素”中找到了同一个点“目标要素”，则输出要素类将存在两个“目标要素”实例，分别包含两个面的属性。

String

join_type

(可选)

确定是在输出要素类中保留所有“目标要素”（外部连接），还是仅保留那些与“连接要素”有指定空间关系的“目标要素”（内部连接）。

  • KEEP_ALL —将在输出中保留所有“目标要素”（外部连接）。这是默认设置。
  • KEEP_COMMON — 仅在输出要素类中保留那些与“连接要素”有指定空间关系的“目标要素”（内部连接）。例如，如果将某个点要素类指定为“目标要素”，将某个面要素类指定为“连接要素”，并选择“WITHIN”作为匹配选项，则输出要素类将仅包含那些位于面“连接要素”中的“目标要素”，非“连接要素”内部的“目标要素”将被排除。

Boolean

field_mapping

(可选)

控制输出要素类中要包含的属性字段。可以添加、删除、重命名字段或更改字段的属性。初始列表既包含“目标要素”中的字段，也包含“连接要素”中的字段。

Field Mappings

match_option

(可选)

定义用于匹配行的条件。只要找到该空间关系（或匹配选项），就会将“连接要素”的属性传递到“目标要素”。匹配选项包括：

  • INTERSECT：如果“目标要素”与“连接要素”相交，则将“连接要素”的属性传递到“目标要素”。
  • CONTAINS：如果“目标要素”包含“连接要素”，则将“连接要素”的属性传递到“目标要素”。对于此选项，“目标要素”不能为点，且仅当“目标要素”为面时“连接要素”才能为面。
  • WITHIN：如果“目标要素”位于“连接要素”内部，则将“连接要素”的属性传递到“目标要素”。对于此选项，“连接要素”不能为点，且仅当“连接要素”为面时“目标要素”才能能为面。
  • CLOSEST：将最近“连接要素”的属性传递到“目标要素”。

String

search_radius

(可选)

如果“连接要素”与“目标要素”的距离在此范围内，则将进行空间连接。仅当将空间关系（或匹配选项）指定为INTERSECT 或 CLOSEST 时，搜索半径才有效。空间关系为 INTERSECT 时使用 100 米作为搜索半径表示：如果“连接要素”位于“目标要素”周围的 100 米范围内，则将“连接要素”的属性传递到“目标要素”。空间关系为CLOSEST 时使用 100 米作为搜索半径表示：如果“连接要素”位于“目标要素”周围的 100 米范围内，并且是距该“目标要素”最近的“连接要素”，则将“连接要素”的属性传递到“目标要素”。

Linear unit

distance_field_name

(可选)

向输出要素类中添加的字段的名称，用于包含“目标要素”和最近“连接要素”之间的距离。仅当将空间关系（或匹配选项）指定为 CLOSEST 时，此选项才有效。如果未指定字段名称，将不会向输出要素类中添加该字段。

String
国外论坛一段代码可以参考： 
public void GP_SpatilaJoin_Intersect_OneToMany_KeepALL(IFeatureClass pFClassReachPoints, IFeatureClass pFClassCoverage)
        {
            //Define Geoprocessing variables and environment
            IGeoProcessor  pGp   = null;
            IVariantArray  pToolParams   = null;
            IDataElement pDataElement  = null;
            IDETable pDETableA    = null;
            IGPUtilities pGPU    = null;
            IArray pArray    = null;
            IGPFieldMapping pFieldMapping   = null;
            IField pTextField  = null;
            IGPFieldMap pTxtFieldMap = null;

            string targetFeatures = @"D:\ESRI\ETISALAT\ReachPointsApplication\Shapefiles\ReachPointsTemp1.shp";
            string  joinFeatures = @"Database Connections\EMEGS.sde\EMEGS.EG_ENGINEERING_DS\EMEGS.EG_COVERAGE_LIVE_PG";
           
            //Output will be the target features, states, with a mean city population field (mcp)
            string  outfc  = @"D:\ESRI\ETISALAT\ReachPointsApplication\Shapefiles\ReachPointsTemp5.shp";
            pGp = new GeoProcessor();
            pGp.AddToolbox(@"C:/Program Files/ArcGIS/ArcToolbox/Toolboxes/Spatial Analyst Tools.tbx");
            // Create a new fieldmappings and add the two input feature classes.
            IGpFieldMappingsObject fieldmappings = new GpFieldMappingsObject() ; 
           // fieldmappings = gp.CreateObject("FieldMappings")
            fieldmappings.AddTable(targetFeatures);
            fieldmappings.AddTable(joinFeatures);

            // First get the TECHNOLOGY_TYPE fieldmap in Coverage PG  feature class.
            IGpFieldMapObject fieldmap = fieldmappings.GetFieldMap(fieldmappings.FindFieldMapIndex("TECHNOLOGY_TYPE")) as IGpFieldMapObject;
            //Set the merge rule to mean and then replace the old fieldmap in the mappings object with the updated one
            
            fieldmap.MergeRule = "join";// esriGPFieldMapMergeRule.esriGPFieldMapMergeRuleJoin; //
            // fieldmap.JoinDelimiter = "_";
            fieldmappings.ReplaceFieldMap(fieldmappings.FindFieldMapIndex("TECHNOLOGY_TYPE"), fieldmap);

       

            // fieldmap.FieldMap.GetField().Name
            pToolParams = new VarArray();
            pToolParams.Add(targetFeatures);
            pToolParams.Add(joinFeatures);
            pToolParams.Add(outfc);
            pToolParams.Add("JOIN_ONE_TO_ONE");
            pToolParams.Add("KEEP_ALL");
            pToolParams.Add(fieldmappings);
            pToolParams.Add("INTERSECTS");
            pGp.Execute("SpatialJoin_analysis", pToolParams, null);
}

 

esri官网的帮助：

标签：

相关文章