> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyclemate.club/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep link to routing

> Open a pre-filled route in our apps or the web planner with one URL

## Overview

One URL opens a pre-filled route everywhere:

```
https://cyclemate.club/search?<parameters>
```

* On iOS with the app installed, the link opens the planner in the app with the route filled in.
* On Android with a recent version of the app installed, it does the same.
* Everywhere else, including devices without the app, it opens the web planner.

No API key or account is needed, and the link works for riders who are not signed in. The parameters are the same query string documented on [Embed a route](/api-reference/routing/embed): the `origin_*` and `dest_*` trios, up to three `stopN_*` stops, `supersafe`, `departure_time`, `parking`, and `operator`.

One difference from embeds: the origin is optional here. A link carrying only a destination starts the route from the rider's current location.

```
https://cyclemate.club/search?dest_lng=-0.114500&dest_lat=51.504500&dest_name=South%20Bank&parking=ebike&operator=forest&departure_time=2026-08-14T22:30
```

That example routes the rider from wherever they are to the South Bank for a 22:30 departure, ending at a Forest e-bike bay with a short walk to the destination.

## App scheme

To target the app directly, the same path and parameters work on the app scheme:

```
com.cyclemate.app://search?<parameters>
```

A scheme link never opens the web planner. On a device without the app it goes nowhere, so only use it where you handle that case yourself; the `https://cyclemate.club/search` form is the safe default.

## Good to know

* A waypoint travels as a trio: longitude, latitude, and a display name. A waypoint missing any of the three is ignored.
* `departure_time` is a bare wall-clock string (`"YYYY-MM-DDTHH:mm"`) in the route city's timezone. Do not append a timezone offset or a `Z`.
* Coordinates are read to 6 decimal places.
* Links to `https://cyclemate.club/search` open in the app only once the rider's device has picked up our latest link configuration, which happens automatically on install and update.