How can I test Remote Control?

We have made a test system available to you so you can try out the functions of Remote Control without needing additional programming.

Note: You can only access the pages if pop-ups are allowed in your browser. If the pages are not displaying, check your browser settings and disable the pop-up blocker in use.

1. Transferring the parameters and stop-off points via an HTML form

On the remote_test site you can transfer all of the necessary parameters and stop-off points for route calculation to the Remote Control API. The information on the page is automatically URL-encoded and transferred in the right sequence and in the right format.

Note: You can find a detailed description of the parameters that can be transferred to the Remote Control API in the article What parameters can I transfer?.

After installation, the test site for transferring parameters can be found at: http://<Web server name or IP>/mgi2023/remote/remote_test.html

Note: During installation, the virtual directory name mgi2023 may have been changed by the administrator.

The form is divided into three areas.

Login parameters

Here you can enter the user name, password and language.

Routing parameters

You can enter up to four stop-off points in this area.

Note: The restriction to a maximum of four stop-off points applies to the test website. You can transfer more stop-off points in the live version. The only restriction is the maximum URL length stipulated by some browsers.

The fields for a stop-off point must be transferred in the following sequence, separated by a "|" character:

Example of an address transfer:

||||76131|Karlsruhe||Haid-und-Neu-Strasse|13-15|||||||||||

Use clearlist to specify whether the stop-off points should be attached to an existing stop-off point list in PTV Map&Guide intranet or whether an existing stop-off point list should be deleted in advance.
The action parameter controls whether stop-off points should just be added or whether the route should be calculated.
You can use vehicle to enter the vehicle that should be used to plan the route.

Note: If you transfer reference vehicles, the vehicle name must be entered in the language used for the login. For example, if the login was in English, you can transfer reference vehicles RF truck 40t, RF truck 11.99t, RF truck 7.49t, RF transporter (LDCV), RF trailor truck or RF car. As an alternative, you can transfer the vehicle ID. You can display the vehicle ID by showing the relevant column in the vehicle list in the vehicle management use case in PTV Map&Guide intranet (see How can I transfer a vehicle with Remote Control?).

Export parameters

In this area you define how routing results should be transferred and where they should be transferred to.

The ticketid parameter can be used to transfer a unique ID which the receiving system can use to assign the order.
The exportmode parameter determines how the results are returned.

Note: Please note that in the online version of PTV Map&Guide intranet, returns can only be provided via the "callback" function (parameter=0) as a URL. The calling web server must also be set to "https".
With the intranet version, you have the option of writing back the results as a file.
In the live version, you enter the URL of the calling system as exporturl.

For test purposes, you can use the page https://remoteserverdemo.azurewebsites.net/api/routes and it can receive the result. Please note that the page is publicly accessible and can be viewed by anybody.

Note: Not all parameters received are displayed in the test system. You can find a complete list of the transferred parameters on page Overview of the return parameters.
You can use the exportformat parameter to specify whether the result should be returned in JSON or XML format.
Send to Remote Control API opens PTV Map&Guide intranet with the transferred user name, and the stop-off points and parameters are transferred.

Depending on the value of the action parameter, the route is either calculated directly or only the stop-off points are inserted.

2. Transfer of the results from PTV Map&Guide intranet

Once the route has been calculated, on the live version you can send the results back to the calling system. The parameters are transferred after route calculation in the area Results of route calculation > Remote Export.

In the test system, the results are received by the page https://remoteserverdemo.azurewebsites.net/api/routes.

You can find a demo overview site of Remote Control requests at https://remoteserverdemo.azurewebsites.net/.

Note: Please note that the pages are publicly accessible and can be viewed by anybody.

Not all parameters are displayed in the test system. You can find a complete list of the transferred parameters on page Overview of the return parameters.