ArcObjects Library Reference (Geometry)  

esriSpatialRelationEnum Constants

Spatial relationship types - includes those defined by the OpenGIS Simple Features Specification For OLE/COM, Revision 1.1

Constant Value Description
esriSpatialRelationDisjoint 0 Disjoint.
esriSpatialRelationIntersection 1 Interior intersection or boundary touch, same as 'not disjoint'.
esriSpatialRelationInteriorIntersection 2 Intersection excluding boundary touch
esriSpatialRelationIn 3 OpenGIS relationship 'in' - disallows polyline on boundary of polygon.
esriSpatialRelationWithin 4 Same as esriSpatialRelationIn; but in addition, geometry can be on boundary.
esriSpatialRelationPointTouch 5 Boundary intersection is of dimension zero and interiors are disjoint.
esriSpatialRelationLineTouch 6 Boundary intersection is of dimension one and interiors are disjoint.
esriSpatialRelationTouch 7 Point-touch or line-touch (OpenGIS touch relationship).
esriSpatialRelationLineCoincidence 8 Boundary intersection is of dimension one. Interiors may or may not intersect.
esriSpatialRelationCross 9 The interiors of two lines intersect in a point, or the interiors of a line and polygon intersect in a line.
esriSpatialRelationOverlap 10 Two lines share a common sub-line, or two areas share a common sub-area.
esriSpatialRelationRelation 11 Allows specification of any relationship in the Dimension Extended Nine Intersection Model.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Remarks

Used by methods on IRelationalOperatorNxM and by methods on IGeometryServer. esriGeometrySpatialRelation is an enumeration used by the web services interface for the Geometry Server and is a synonym for this enumeration.
Name Description
esriSpatialRelationDisjoint Same as IRelationalOperator::Disjoint. The zero-based index of a geometry from pInGA1 and the zero-based index of a geometry from pInGA2 define an element of the output array of relation results if the geometries are completely separate from each other. See IRelationalOperator_Disjoint for some examples of the disjoint relation. There are no additional restrictions on the types of geometries in the input arrays.
esriSpatialRelationIntersection The opposide of esriSpatialRelationDisjoint. An element of the output array will specify the indexes of geometries from the input arrays if they share some point in the xy plane. There are no additional restrictions on the types of geometries in the input arrays.
esriSpatialRelationInteriorIntersection Same as esriSpatialRelationIntersection, but excludes intersections that occur only at boundaries (two touching polygons for example). The interior of a point is considered to be the point itself and the interior of a polyline excludes the endpoints of all its parts. There are no additional restrictions on the types of geometries in the input arrays. (check this)
esriSpatialRelationIn, esriSpatialRelationWithin These relations are similar. esriSpatialRelationIn is the same as IRelationalOperator::Within. esriSpatialRelationWithin also allows polylines that are strictly on the boundaries of polygons to be considered “in” the polygon. This case is disallowed by the former relation (and disallowed by IRelationalOperator::Within). The dimension of all geometries in pInGA1 must be > = the dimension of geometries in pInGA2.

esriSpatialRelationPointTouch, esriSpatialRelationLineTouch, esriSpatialRelationTouch

esriSpatialRelationPointTouch and esriSpatialRelationLineTouch are boundary intersectionsclassified by dimension of intersection. esriSpatialRelationTouch is the union of those two and is equivalent to the ArcObjects IRelationalOperator Touch method.

These relations are defined for polylines and polygons.

esriSpatialRelationLineCoincidence The boundaries of the shapes must share a 1D intersection, but the relationship between the interiors of the shapes is not considered (they could overlap, one could be contained in the other, or their interiors could be disjoint). This relation applies to polylines and polygons.
esriSpatialRelationCross Same as the ArcObjects IRelationalOperator::Cross method. Lines can cross other lines at a point and lines can cross polygons. See IRelationalOperator_Crosses for examples.
esriSpatialRelationRelation 'param' defines the 'Shape Comparison Language' string to be evaluated. Strings such as ’FFFTTT***' are accepted, in addition to other kinds of strings. See the following EDN topic for more details on the Shape Comparison Language. http://edndoc.esri.com/arcobjects/9.2/NET/40de6491-9b2d-440d-848b-2609efcd46b1.htm