Provides access to the route creation properties and methods. Note: the IRouteMeasureCreator interface has been superseded byIRouteMeasureCreator2. Please consider using the more recent version.
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.
|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.|
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.