erm createsegmentupdate

Note: For instructions on installing and running the Administration Utility, see Getting Started with the Administration Utility.

The erm createsegmentupdate command overrides the routing data of the specified segment. This command allows you to set or change the speed, exclude a section of the route, or change the road type. You must have the Spatial Module installed to use this command.

Note: The type of persistent update is valid only for the specified data resource and may not be valid after a data update.

Usage

erm createsegmentupdate --datasource db_resource --segmentid "segment_id" --exclude --velocity velocity_value --velocityunit velocity_unit --velocityadjustment velocity_adjustment_value --velocitypercentage velocity_percentage_value --roadtype road_type

Note: To see a list of parameters, type help erm createsegmentupdate.

Required	Argument	Description
Yes	--datasource `db_resource`	Specifies the name of the database resource to override the data. For a list of existing routing database resources, use the ermdb list command.
Yes	--segmentid `"segment_id"`	Indicates the segment to override. The segment is specified in the format specified in the data. For example, `"7e3396fc:6e5251"`.
No	--exclude	Excludes the specified segment from all route calculations when set to true. Having this parameter in the command specifies whether to exclude the segment. To avoid the exclusion, add false after --exclude.
No	--velocity `velocity_value`	Defines a speed update where you specify the new speed of the segment by specifying the new velocity. The default unit is mph(miles per hour) unless you specify the velocityunit parameter.
No	--velocityunit `velocity_unit`	Defines a unit of speed for the velocity or velocityadjustment overrides. The value is mph(miles per hour). For speed updates, the velocity unit can have one of the following values: kph (kilometers per hour), mps(meters per second), or mph (miles per hour).
No	--velocityadjustment `velocity_adjustment_value`	Defines a speed update where you define a change in the speed of the segment by specifying the change in velocity (unit and value). Speed values can be increased (positive value) or decreased(negative value). The default unit is mph(miles per hour) unless you specify the velocityunit parameter.
No	--velocitypercentage `velocity_percentage_value`	Defines a speed update where you define an increase in the speed of the segment by specifying a percentage to increase(positive value) or decrease(negative value) the speed.
No	--roadtype `road_type`	Defines the new road type for the segment.

Examples

This example overrides the speed of the segment to 15 mph, from the US_NE database resources configured on the server.

erm createsegmentupdate --datasource US_NE --segmentid "7e3396fc:6e5251" --velocity 15 --velocityunit mph

This example excludes the specified segment from the US_NE database resources configured on the server.

erm createsegmentupdate --datasource US_NE --segmentid "7e3396fc:6e5251" --exclude true

This example overrides the speed of the segment by increasing the speed by 45 kph, from the US_NE database resources configured on the server.

erm createsegmentupdate --datasource US_NE --segmentid "7e3396fc:6e5251" --velocityadjustment 45 --velocityunit kph

This example overrides the speed of the segment by decreasing the speed by 60 percent, from the US_NE database resources configured on the server.

erm createsegmentupdate --datasource US_NE --segmentid "7e3396fc:6e5251" --velocitypercentage -60

This example overrides the road type of the segment to ferry, from the US_NE database resources configured on the server.

erm createsegmentupdate --datasource US_NE --segmentid "7e3396fc:6e5251" --roadtype ferry