ResRobot Deep Links

What does this API provide?

ResRobot deep links allow you to create links that point directly to specific results in the ResRobot web application.

Data format

You will get a redirect to the page with results.

How often is this data updated?

The static data used for this API is updated when changes are made, at most once per day.

Which operators are covered by this dataset?

All operators which operate in Sweden are covered by the ResRobot APIs.

How often does the data format changes? Do breaking changes happen?

This API has the stable status. When breaking changes are made, you will get six months or more to update your implementations. Examples of breaking changes are the changes to existing fields or query parameters, or in case new query parameters are required to keep the results the same. The addition of new fields isn’t considered a breaking change, and can happen without warning.

In order to use deep links into ResRobot results, you construct the request URL based on the parameters you want to show results for, and redirect the user who needs to see the results to this URL. This allows you to show users route-plannings directly from your website or app, without any need to implement your own user-interface.

Request and response

Requests

No key required

This API does not require an API key.

Example 1: Route between specific stops

https://reseplanerare.resrobot.se/bin/query.exe/sn?&S=740000044&Z=740000001&start=1

Example 2: Between coordinates

https://reseplanerare.resrobot.se/bin/query.exe/[email protected][email protected][email protected]=Uppsala&Z=740000001&time=12:00×el=arrive&start=1

Request parameters

Parameter Required Description Example
S Either S or SID are required extId for the origin stop. This id can be obtained through the stop lookup API or the nearby stops API. Can not be used in combination with the SID parameter. 740000044 (for Helsingborgs Centralstation)
SID Either S or SID are required A so-called “triple id” containing the name and coordinates for the place of departure. Syntax: [[email protected]=<X-coordinate>@Y=<Y-coordinate>@O=<name>.
Coordinates must be in WGS84 format, with 6 digits precision but without comma. Name is the name shown to the user and does not affect the search. Can not be used in combination with the S parameter.
[email protected][email protected][email protected]=Uppsala
Z Either Z or ZID are required extId for the origin stop. This id can be obtained through the stop lookup API or the nearby stops API. Can not be used in combination with the SID parameter. 740000001 (for Stockholm Centralstation)
ZID Either Z or ZID are required A so-called “triple id” containing the name and coordinates for the place of arrival. Syntax: [[email protected]=<X-coordinate>@Y=<Y-coordinate>@O=<name>.
Coordinates must be in WGS84 format, with 6 digits precision but without comma. Name is the name shown to the user and does not affect the search. Can not be used in combination with the S parameter.
[email protected][email protected][email protected]=Home
timesel No, default depart Indicates if the specified time and date are the departure or arrival date/time. Can be arrive or depart. depart
date No, default today Date of departure or arrival, in the YYYY-MM-DD format 2020-12-31
time No, default now Time of departure or arrival, in the YYYY-MM-DD format 15:23
start Yes Must be set to 1 1

Response

You will receive a meta-redirect to the route-planning page.

<html>
<head>
    <meta http-equiv="Refresh"
          content="0; url=https://reseplanerare.resrobot.se/index.html#!P|TP!SID|A%3D16%40O%3DUppsala%40X%3D17703271%40Y%3D59869065%40!S|Uppsala!ZID|A%3D1%40O%3DStockholm%20Centralstation%40X%3D18058151%40Y%3D59330136%40U%3D1%40L%3D740000001%40B%3D1%40V%3D74.9,%40p%3D1633491748%40!Z|Stockholm%20Centralstation!date|07.10.2021!time|12:00!start|1"/>
    <script>location.replace('https://reseplanerare.resrobot.se/index.html#!P|TP!SID|A%3D16%40O%3DUppsala%40X%3D17703271%40Y%3D59869065%40!S|Uppsala!ZID|A%3D1%40O%3DStockholm%20Centralstation%40X%3D18058151%40Y%3D59330136%40U%3D1%40L%3D740000001%40B%3D1%40V%3D74.9,%40p%3D1633491748%40!Z|Stockholm%20Centralstation!date|07.10.2021!time|12:00!start|1');</script>
</head>
<body>
The journey planner moved to a new url.<br>
<a href="https://reseplanerare.resrobot.se/index.html#!P|TP!SID|A%3D16%40O%3DUppsala%40X%3D17703271%40Y%3D59869065%40!S|Uppsala!ZID|A%3D1%40O%3DStockholm%20Centralstation%40X%3D18058151%40Y%3D59330136%40U%3D1%40L%3D740000001%40B%3D1%40V%3D74.9,%40p%3D1633491748%40!Z|Stockholm%20Centralstation!date|07.10.2021!time|12:00!start|1">Click
    here to start the journey planner</a>
</body>
</html>