Retrieving a Calculated Route from the Server
The route information is cached on the server for 45 minutes after a route was calculated and can be accessed with a fetchRoute operation.
The following listing shows the general structure of the operation in the WSDL file of the Map24 Routing Service:
...
<message name="fetchRouteRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="FetchRouteRequest" type="tns:FetchRouteRequest" />
</message>
<message name="fetchRouteResponse" >
<part name="FetchRouteResponse" type="tns:FetchRouteResponse" />
</message>
...
<portType name="Map24RoutingPortType" >
<operation name="fetchRoute" >
<input message="tns:fetchRouteRequest" />
<output message="tns:fetchRouteResponse" />
</operation>
...
</portType>
...
Request
FetchRouteRequest contains the parameters for the fetchRoute operation.
| Field |
Description |
| RouteID |
The RouteID that was delivered in the CalculateRouteResponse. The RouteID must be set to identify the calculated route on the server. |
| SpeedClassification |
Can be used to specify the assumed average speed on different road types. The unit is kilometers per hour. More information is provided here.
|
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. |
| LoadTMCs |
If TRUE, traffic information along the calculated route is provided. |
| DescriptionLanguage |
The language for the textual route description. The DescriptionLanguage must be the language's ISO code. |
| RoutingServiceID |
The ID of the Routing Service to use. Usually you will not have to set this ID. If not set, the default will be used that is set in the MapTP environment. For more information see here.
|
| Properties |
Additional properties. |
Response
FetchRouteResponse delivers the requested route of type Route.
Examples
An example SOAP request is provided here.
|
