Geometry Service Relation method

Determines the pairs of geometries from the input geometry arrays that participate in the specified spatial relation.

 

Relation(SpatialReference SpatialReference, Geometry[] InGeometryArray1, Geometry[] InGeometryArray2, esriGeometryRelationEnum  RelationName, string RelationParameter)

 

Parameter

Description

SpatialReference

SpatialReference of the geometries in both input geometry arrays.  Cannot be null.
 

InGeometryArray1

Base set of Geometry in the relation operation.  The relationship between each Geometry in the base set is compared to each Geometry in the comparison set (InGeometryArray2).  All geometries in this array must be of the same type and are assumed to be in the coordinate system InSpatialReference.  
 

InGeometryArray2

Comparison set of Geometry in the relation operation.   All geometries in this array must be of the same type and are assumed to be in the coordinate system InSpatialReference.
 

RelationName

An esriGeometryRelationEnum to define the type of relation evaluated.
 

RelationParameter

If the RelationName enumeration is esriGeometryRelationRelation, a Shape Comparison Language parameter string can be used.  The Shape Comparison Language is based on the Calculus-Based Method (CBM), as described and defined by Clementini and Felice, but has some extensions specific to working with vertex-based geometries.  Refer to the Shape Comparison Language documentation for proper syntax and available functionality.   
 

 

Return Value

 

A RelationResult[] object for each geometry pair for with the specified relation is true.  The left index is the index of the Geometry in the base array (InGeometryArray1).   The right index is the index of the Geometry in the comparison array (InGeometryArray2).  If the specified relation is not true for a geometry pair, no RelationResult is returned.  

 

Remarks

 
The relations are evaluated in 2D, thus Z coordinates are not used.  Restrictions on the types of geometries in the base of comparison array are associated with the relation.   The discussion for the esriGeometryRelationEnum provides detailed information on the relation operators and restrictions.    

 

Examples

C#

VB.NET

Java