Pitney Bowes MapXtreme - Manual (Page 376)

Chapter 20: Routing
Updating a Request Using Routing Data
MapXtreme v7.1 383 Developer Guide
Updating a Request Using Routing Data
Being able to access and your route data, then use this information to create more accurate and
meaningful routes, is a very useful capability. After you create a route and get a route response, you
may realize that the result contains a location or segment you don't want to pass, and a road type or
segment where you may want to reduce or increase the speed. MapXtreme provides capabilities to
return segment information on your route data and use the information in your route data to
modify/update route requests (transient updates). This means you can update the routing network
without reprocessing the base data.
The transient update process is comprised of two steps:
1. Return the route data segment information in a route response. This information is required to
determine the segments used for the road type or speed update. For more information, refer to
Returning Segment Information .
2. Based on information returned in your response, make temporary updates to the route data. This
is called transient updates. These changes are submitted within a route request, and are only
valid when the server or service is handling that particular request. This capability can be used to
include some dynamic traffic/accident data or to set the preferences for a particular road type.
For more information, refer to
Transient Updates .
Returning Segment Information
In order to avoid or update the road type or speed data for a road segment you will need to know the
segment ID and other road information. MapXtreme provides the ability to return the road segment
data including information such as the segment ID, name, distance, road type, speed, travel time,
geometries, and other important data.
By default, segment information is not returned in a route request. Use the class, and set
ReturnSegmentData to true.You also have the options of defining the units of measure for both the
velocity and angle for the returned information. By default the VelocityUnit is Mph (miles per hour)
and the AngleUnit is Degree. The segment data is the data that is necessary to create the driving
directions and contains detailed information on each segment in the route. The segment information
returned includes:
• the street names (including alternate names)
• the languages for the street names
• compass direction
• segment ID
• one way boolean
• roundabout boolean
• toll road boolean
• road type
• speed limit
• turn angle
• time to traverse the segment
• distance along the segment