Provides access to route measure calibration methods. Note: the IRouteMeasureCalibrator interface has been superseded byIRouteMeasureCalibrator2. Please consider using the more recent version.
Product Availability
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
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. |
CoClasses that implement IRouteMeasureCalibrator
CoClasses and 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.