Calculating a Routing Vector
With the calculateMRouteVector operation you can calculate routes from one start point to all given destination points. For each calculated route a MRouteID is returned that can be used in a subsequent calculateMRoute request to retrieve more detailed information on a single route.
The following listing shows the general structure of the operation in the WSDL file of the Map24 MatrixRouting Service:
<message name="calculateMRoutesVectorRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="CalculateMRoutesVectorRequest" type="tns:CalculateMRoutesVectorRequest" />
</message>
<message name="calculateMRoutesVectorResponse" >
<part name="CalculateMRoutesVectorResponse" type="tns:CalculateMRoutesVectorResponse" />
</message>
<portType name="Map24MatrixRoutingPortType" >
<operation name="calculateMRoutesVector" >
<input message="tns:calculateMRoutesVectorRequest" />
<output message="tns:calculateMRoutesVectorResponse" />
</operation>
</portType>
Request
CalculateMRoutesVectorRequest contains the parameters of a calculateMRouteVector operation.
Fields:
| Field |
Description
|
| Start |
The starting point for all routes that are calculated with a calculateMRouteVector operation. Start is of type MRoutePoint. |
| Destination |
An array of MRoutePoint elements that specify the destination points of a calculateMRouteVector operation. |
| SynchronizeClient |
If TRUE, the calculated routes will be pushed onto the map in the mapping client via MRC commands.
|
| Properties |
Properties for defining which fields are returned in the response as described in the following table.
|
Properties of a CalculateMRoutesVectorRequest:
Key
|
Description |
Possible Values |
| REPLY_NODES |
If TRUE, the nodes along the calculated routes are returned. |
TRUE / FALSE |
| REPLY_Distances |
If TRUE, the distances depending on the street classes are returned. |
TRUE / FALSE |
Response
CalculateMRoutesVectorResponse is the response of the calculateMRoutesVector operation.
Fields:
Field
|
Description
|
| Start |
The start points of all calculated routes. The start points are of type MRoutePoint. |
| Routes |
An array of MRoute elements containing information about the calculated routes. |
Examples
An example request is provided here.
|
