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

The spatial reference of the geometries in both input geometry arrays. This cannot be null. 

InGeometryArray1

The base set of Geometry objects in the relation operation.  The relationship between each object in the base set is compared to each object 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 referenced in SpatialReference.   

InGeometryArray2

The 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 reference in SpatialReference

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 objects are 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