This document is archived and information here might be outdated.  Recommended version.

IRouteMeasureCalibrator Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Location > ESRI.ArcGIS.Location > Interfaces > IR > IRouteMeasureCalibrator Interface
ArcGIS Developer Help

IRouteMeasureCalibrator Interface

Provides access to route measure calibration methods. Note: the IRouteMeasureCalibrator interface has been superseded by IRouteMeasureCalibrator2. Please consider using the more recent version.

Product Availability

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


The IRouteMeasureCalibrator interface is used to calibrate routes at a feature class level. 

Routes can be calibrated by two methods:

An updateHow parameter is passed into the methods to specify whether calibration is to be done on the entire route or on portions of the route.  Here are some examples of upDateHow:

Interpolate = 1
Extrapolate Before = 2
Extrapolate After = 4

A boolean parameter allRoutes is passed into the methods to specify whether all routes are be be included into the output, even the ones which are not calibrated due to no calibration points on the route.

For disjoint routes, gaps can be ignored or not ignored by setting the boolean parameter ignoreGaps to True or False.  For CalibrateRoutesByMs, this property is always True.   

See IRouteMeasureCalibrator2.


Name Description
Read/write property BuildOutputIndex Indicates whether an index is going to be built on the route id field on the output result.
Method CalibrateRoutesByDistance Calibrate route features.
Method CalibrateRoutesByMs Calibrate route features by using existing M values for the interpolation.
Read/write property InputFeatureClass The input features to locate along the routes.
Read/write property InputFeatureSelection A selection set of features to locate.
Read/write property InputMeasureFieldName The input measure field name.
Read/write property InputRouteIDFieldName The input route identifier field name.
Read/write property RouteLocator The route locator.

Classes that implement IRouteMeasureCalibrator

Classes Description
RouteMeasureCalibrator Route Measure Calibration Object.


The results of CalibrateRoutesByDistance and CalibrateRoutesByMs is an IEnumBSTR, which is a container for the list of errors encountered during route calibration. 


See Also

IRouteMeasureCalibrator2 Interface