ArcObjects Library Reference (Location)

IRouteMeasureCreator Interface

Provides access to the route creation properties and methods. Note: the IRouteMeasureCreator interface has been superseded byIRouteMeasureCreator2. Please consider using the more recent version.

Product Availability

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

Description

The IRouteMeasureCreator interface allows you to create route features at a feature class level.

Routes can be created from a line feature class in three different ways depending on how the measures are to be set.

CreateUsingCoordinatePriority - measures are set using one field from the input feature class. Measures will be accumulated from the origin point.
CreateUsing2Fields - measures are set using two fields from the input feature class which represent the from and to measure values.
CreateUsingPoints - measures are set by calibration points. Points reside in a point feature class which contains the route identifier each point refers to and the measure value at that location.

The InputFeatureClass property is used to set the line feature class the routes are to be created from. The InputRouteIDFieldName property is used to specify the field name from the input feature class from which lines will be aggregated to compose a route.

If not all of the line features are desired for route creation, the InputFeatureSelection property can be used to specify an ISelectionSet.

See IRouteMeasureCreator2.

Members

		Description
	BuildOutputIndex	Indicates whether an index is going to be built on the route id field on the output result.
	CreateUsing2Fields	Create routes from polylines using two fields.
	CreateUsingCoordinatePriority	Create routes from using topology.
	CreateUsingPoints	Create routes from polylines using points to assign measures.
	InputFeatureClass	The input features.
	InputFeatureSelection	A selection set of input features.
	InputRouteIDFieldName	The input route identifier field name.

CoClasses that implement IRouteMeasureCreator

CoClasses and Classes	Description
RouteMeasureCreator	Basic route creation object.

Remarks

All of the three methods above require you to pass in an IGeometryDef for the output or resultant feature class. The output GeometryDef must have HasM set to True.

The results of CreateUsingTopology, CreateUsing2Fields, CreateUsingPoints is an IEnumBSTR, which is a container for the list of errors encountered during route creation.