TerrainRouteOperator.RouteZMeaning Property
Gets or sets a value that specifies the meaning of z coordinates in the output route: either elevation or local travel time.
Syntax
public TerrainRouteZMeaning RouteZMeaning { get; set; }Property Value
Default: Elevation
A value that specifies the meaning of z coordinates in the output route: either elevation or local travel time.
Remarks
By default, each z coordinate gives the route node elevation, which is normally taken from the elevation raster, since road datasets usually lack elevation information. But where the route follows a bridge or a tunnel, the elevation raster would be misleading and there is no way to find the true elevations. So, route node elevations on a bridge or tunnel are just interpolated linearly between the two nearest adjacent route nodes with known elevations. If only one end of the bridge or tunnel part of the route has a known elevation, this will be used for all route nodes on the bridge/tunnel, and if neither end has a known elevation, zero will be used.
By setting this property to TravelTime instead, one can force the z coordinate for each route node to give the local travel time to the node from the start of the current route leg. Note that if there are more than two waypoints, and therefore more than one route leg in the output, the travel times will restart from zero for each leg: this is because the operator may have failed to generate a previous route leg, so accumulated travel times from the very first waypoint may not be available.
The travel times are useful if you are making a simulation with vehicles advancing along the route, and you want the vehicle speed to vary with the route difficulty.
Platforms
Windows, Linux, Android