Retrieving Infomation on a Single Route
After calculating routes with a calculateMRoutesVector or calculateMRoutesMatrix operation, you can use the calculateMRoute operation to retrieve information on one single route. You must pass the MRouteID of the route in the request. The returned RouteID can be used to identify the route in subsequent requests.
The following listing shows the general structure of the operation in the WSDL file of the Map24 MatrixRouting Service:
<message name="calculateMRouteRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="CalculateMRouteRequest" type="tns:CalculateMRouteRequest" />
</message>
<message name="calculateMRouteResponse" >
<part name="CalculateMRouteResponse" type="tns:CalculateMRouteResponse" />
</message>
<portType name="Map24MatrixRoutingPortType" >
<operation name="calculateMRoute" >
<input message="tns:calculateMRouteRequest" />
<output message="tns:calculateMRouteResponse" />
</operation>
</portType>
Request
You can set the parameters for the calculateRoute operation in a CalculateMRouteRequest element.
Fields:
| Field |
Description
|
| MRouteID |
A unique ID for the calculated route that is used within the MatrixRouting Service to reference the route in further requests. For example, it is possible to retrieve more detailed information about the route (description, shape, etc.) with a calculateMRoute request, passing the MRouteID in the request. |
| VehicleType |
Type of the vehicle with which the route is traversed. The value can be either "Car" or "Pedestrian". It is "Car" by default. In case of "Pedestrian" motorways are not used. Furthermore, one-way rules and other direction instructions are ignored in this case. |
| SpeedClassification |
An optional field of type SpeedClassification for specifying the assumed average speed on different road types.
|
| IgnoreWaypoints |
When setting this flag to True, only one coordinate per route segment will be returned. If this flag is set to FALSE (the default), the complete geometry of the route is returned. This setting does not have any effect on the display of the route. |
| IgnoreDescription |
If TRUE, only the RouteID is returned. If FALSE (the default), the RouteID and a detailed route description is returned. The RouteID is needed to identify the route information on the server in subsequent requests. |
| DescriptionLanguage |
The language for the textual route description. Use the two-letter language code as specified in ISO 639-1. The following languages are supported: Czech (cs), German (de), Danish (da), English (en), Spanish (es), Finnish (fi), French (fr), Italian (it), Dutch (nl), Norwegian (no), Polish (pl), Portuguese (pt), Russian (ru), Swedish (sv), Turkish (tr).
If no DescriptionLanguage is specified, the language associated with the Map24 ID in the RequestHeader will be used. |
| LoadTMCs |
If you have a license from the NAVTEQ GmbH for retrieving traffic information, you can receive traffic information along the calculated route by setting the LoadTMCs flag to TRUE. |
Response
CalculateMRouteResponse is the response of a calculateMRoute operation.
Fields:
| Field |
Description
|
| MRouteID |
A unique ID for the calculated route that is used within the MatrixRouting Service to reference the route in further requests. For example, it is possible to retrieve more detailed infomation about the route (description, shape, etc.) with a calculateMRoute request, passing the MRouteID in the request. |
| Route |
The calculated route of type Route. A calculated route consists of a sequence of route segments from the route's start to its destination point and some additional infomation on the route. The RouteID, the TotalLength and the TotalTime elements are always returned in a calculateMRoute request. The RouteID is needed if the route is accessed in subsequent requests. |
Examples
An example request is provided here.
|
