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.

Description

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

Routes can be calibrated by two methods:

CalibrateRoutesByDistance - calibrates by using new measure values from the input points (InputFeatureClass) and the shortest path distance along the polyline between these points.
CalibrateRoutesByMs - calibrates by using new measure values from the input points and the existing measure distance between these points.

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.

Members

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

Classes that implement IRouteMeasureCalibrator

Classes	Description
RouteMeasureCalibrator	Route Measure Calibration Object.

Remarks

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