Route Planning Expansion in the Mapy.com REST API

1. 12. 2025

We have expanded the route-planning function in the Mapy.com REST API. The changes are based on frequent feedback from our users.

We are not breaking backward compatibility — the existing interface and behavior remain unchanged, we are only adding new input and output parameters. No adjustments to current integrations are required.

New input parameters

avoidHighways
In addition to the existing avoidToll parameter (avoid toll roads), we are introducing avoidHighways, which allows route planning to avoid highways / express roads.
departure
Optional departure time in local time (ISO-8601, e.g. 2025-01-01T00:00:00.000). If not provided, planning uses “now”. This parameter affects time-dependent restrictions (closures, traffic limits, etc.).

New output parameters

parts
An array of route segments between the start, optional waypoints, and destination. Each segment includes its own length (in meters) and duration (in seconds).
routePoints
An array with detailed information about the start, destination, and waypoints after snapping to the routing network.
Values originalPosition, mappedPosition, and snapDistance describe the shift to the nearest routable edge.
If restricted = true, the point lies in an area that would normally be excluded from routing (e.g., a limited-access or non-routable area), but the route was still calculated because the point was explicitly specified as start, end, or waypoint. The restrictionType attribute specifies the reason.

Learn more in the documentation