Route Web Service

What is Route Web Service?

Routing can be done through CalculateSimpleRoute(LatLong, RouteDataset, SegmentPreference). Results are returned in Segments and Directions arrays.

You can return a full list of the datasets that are available from MDSCommonService.GetDataSourceInfo(Nothing). Currently "mapds.au" or "mapds.nz" route Datasets are available.

Route Web Service

Routing can be done through CalculateSimpleRoute(LatLong, RouteDataset, SegmentPreference). Results are returned in Segments and Directions arrays.

You can return a full list of the datasets that are available from MDSCommonService.GetDataSourceInfo(Nothing). Currently "mapds.au" or "mapds.nz" route Datasets are available.

Distance

Itinerary.Distance
Itinerary.Segments.Directions.Distance

Times

Itinerary.DrivingTime
Itinerary.Segments.Directions.Duration

Avoidance

Set in SegmentPreference.avoidPreference (see enumerations table under AvoidanceMask for options). This is set then passed to CalculateSimpleRoute. How do I set more than one avoidance category

Multiple scenarios

Set in SegmentPreference. buildPreference (see enumerations table under SegmentBuildType for options).

Itineraries

Itinerary.Segments.Directions.Address.AddressLine

Reference to MDSroute file (stored at MAPDS)

Stored in CalculatedRouteRepresentation.DrawLine.MapFileName As String Eg. Route.CalculatedRepresentation.DrawLine.MapFileName. This can be passed to the Render WebService to draw the route.

Multiple via points routes 20 point Limit - (Agreed use can extend this)

With the use of CalculateSimpleRoute(LatLong, RouteDataset, SegmentPreference)

Parsing LatLong to the function CalculatedSimpleRoute as an array of larger size eg. [0]-[19] for a maximum of 20 [0] as start point [19] as end point [1]-[18] as via points.

Note: more than 20 points per route is available by arrangement with MapData Services

Route Coordinates

Are available by arrangement with MapData Services

Line-vectors (Available on agreed use)

CalculateMultipleRoutes
Allows the efficient creation of multiple routes from the one call. Enhanced access is required
CalculateRoadDistances
Efficiently calculates the set of ROAD DISTANCES between an origin point and a set of destination points. Enhanced access is required
CalculateSimpleRoute
Calculate a route according to the specified settings (Extended to allow the creation of permanent routes)

RetrievePermanentRoutes

Allows the reuse of previously created, purpose built, stored routes.

Request Workflow

  • The general development process for sending a Route request is as follows:
  • 1. Create a new Route request;
  • 2. Create and assign the authentication header to the Route request;
  • 3. Create and assign the required and desired properties in the SegmentPreference class;
  • 4. Create a result using the CalculateSimpleRoute() method;
  • 5. Check the RouteReturnResult code in the result and get the result route;
  • 6. Extract the results from the Route class.