com.esri.arcgis.location
Interface IRouteMeasureCreator2

All Superinterfaces:

IRouteMeasureCreator, Serializable

All Known Implementing Classes:

RouteMeasureCreator

public interface IRouteMeasureCreator2
extends IRouteMeasureCreator, Serializable

Provides access to the route creation properties and methods.

Description

The IRouteMeasureCreator2 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.

The methods on this interface improve upon those on IRouteMeasureCreator. A measure factor can be applied to the measure values. This is useful for converting between measure units. For example, to convert from feet to miles, you would specify a factor of 0.00018939394.

Measure values can also be offset. This is useful when you want your output routes to have a minimum measure other than 0.

Product Availability

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

Method Summary

IEnumBSTR	createUsing2Fields2(String fmFieldName, String tmFieldName, double factor, double offset, IFeatureClassName outputFClassName, IGeometryDef outputGeometryDef, String configKeyword, ITrackCancel trackCancel) Create routes from polylines using two fields.
IEnumBSTR	createUsingCoordinatePriority2(String lengthFieldName, double factor, double offset, int seedingCorner, boolean ignoreGaps, IFeatureClassName outputFClassName, IGeometryDef outputGeometryDef, String configKeyword, ITrackCancel trackCancel) Create routes from using topology.

Methods inherited from interface com.esri.arcgis.location.IRouteMeasureCreator

createUsing2Fields, createUsingCoordinatePriority, createUsingPoints, getInputFeatureClass, getInputFeatureSelection, getInputRouteIDFieldName, isBuildOutputIndex, setBuildOutputIndex, setInputFeatureClassByRef, setInputFeatureSelectionByRef, setInputRouteIDFieldName

Method Detail

createUsing2Fields2

IEnumBSTR createUsing2Fields2(String fmFieldName,
                              String tmFieldName,
                              double factor,
                              double offset,
                              IFeatureClassName outputFClassName,
                              IGeometryDef outputGeometryDef,
                              String configKeyword,
                              ITrackCancel trackCancel)
                              throws IOException,
                                     AutomationException

Create routes from polylines using two fields.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

fmFieldName - The fmFieldName (in)

tmFieldName - The tmFieldName (in)

factor - The factor (in)

offset - The offset (in)

outputFClassName - A reference to a com.esri.arcgis.geodatabase.IFeatureClassName (in)

outputGeometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (in)

configKeyword - The configKeyword (in)

trackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Returns:

A reference to a com.esri.arcgis.system.IEnumBSTR

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createUsingCoordinatePriority2

IEnumBSTR createUsingCoordinatePriority2(String lengthFieldName,
                                         double factor,
                                         double offset,
                                         int seedingCorner,
                                         boolean ignoreGaps,
                                         IFeatureClassName outputFClassName,
                                         IGeometryDef outputGeometryDef,
                                         String configKeyword,
                                         ITrackCancel trackCancel)
                                         throws IOException,
                                                AutomationException

Create routes from using topology.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

lengthFieldName - The lengthFieldName (in)

factor - The factor (in)

offset - The offset (in)

seedingCorner - A com.esri.arcgis.location.esriMSeedingCorner constant (in)

ignoreGaps - The ignoreGaps (in)

outputFClassName - A reference to a com.esri.arcgis.geodatabase.IFeatureClassName (in)

outputGeometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (in)

configKeyword - The configKeyword (in)

trackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Returns:

A reference to a com.esri.arcgis.system.IEnumBSTR

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.