--- metadata: - name: generator content: Diplodoc Platform v5.48.2 alternate: - https://yandex.com/support/taxi-distr/en/api/deeplinks.md - https://yandex.com/support/taxi-distr/ru/api/deeplinks.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/taxi-distr/ru/llms.txt # Продвинутое формирование ссылок на заказ Чтобы перенаправить пользователя на сайт или в мобильное приложение, необходимо сформировать ссылку, которая содержит параметры поездки. После перехода по такой ссылке пользователь увидит построенный маршрут поездки и сможет заказать такси. Ссылка по умолчанию ведет в приложение, если оно установлено у пользователя. Если приложение не установлено, то дальнейшее поведение ссылки определяется связкой параметров `app_code` и `appmetrica_tracking_id`: {% cut "Возможные значения параметров" %} Сервис | Перенаправление | Значение параметра `app_code` | Значение параметра `appmetrica_tracking_id` ----- | ----- | ----- | ----- Яндекс Go | Страница приложения Яндекс Go в магазине приложений | 3 | 1178268795219780156 Яндекс Go | Сайт [Яндекс Go](https://taxi.yandex.ru/#index) | 3 | 25395763362139037 {% endcut %} Использование ссылок позволяет собирать статистику заказов. Для получения статистики по вашим заказам напишите на [taxi-api@yandex-team.ru](mailto://taxi-api@yandex-team.ru). ## Формат ссылки {#section_qfs_zmb_dcb} ``` https://[](*app_code).redirect.appmetrica.yandex.com/route? [start-lat](*start-lat)=<широта> &[start-lon](*start-lon)=<долгота> &[end-lat](*end-lat)=<широта> &[end-lon](*end-lon)=<долгота> &[tariffClass](*tariffClass)=<тариф> &[ref](*ref)=<источник> &[appmetrica_tracking_id](*appmetrica_tracking_id)=<идентификатор_перенаправления> &[lang](*lang)=<язык> ``` Параметры: **app_code** : Идентификатор сервиса, приложение которого необходимо открыть. Обязательный параметр. Значение параметра для приложения Яндекс Go: 3 Если на устройстве пользователя приложение не установлено, логика редиректа определяется параметром [appmetrica_tracking_id](#apptracking-param). **start-lat** : Широта точки отправления. Необязательный параметр. Используется совместно с параметром `start-lon`. **start-lon** : Долгота точки отправления. Необязательный параметр. Используется совместно с параметром `start-lat`. **end-lat** : Широта точки назначения. Необязательный параметр. Используется совместно с параметром `end-lon`. **end-lon** : Долгота точки назначения. Необязательный параметр. Используется совместно с параметром `end-lat`. **tariffClass** : [Текстовый идентификатор тарифа](https://yandex.com/support/taxi-distr/ru/api/trip-info.md#class-name-desc). Совпадает со значениями `class` в запросах к API и ответом API в поле `class_name`. Необязательный параметр. Доступен только при указании начальной или конечной точек маршрута. **ref** : Идентификатор источника. В данном параметре передается идентификатор [партнерской программы](https://go.yandex/ru_ru/lp/partner-program), или, если его нет, название вашего ресурса. Значение в данном параметре должно содержать только латинские символы. Например, для ресурса mywebsite.ru можно передавать идентификатор `mywebsiteru`. **appmetrica_tracking_id** : Идентификатор, который определяет логику редиректа. Обязательный параметр. Если у пользователя уже стоит приложения Яндекс Go, то ссылка сработает как deeplink и отправит пользователя в приложение. Возможные значения зависят от сервиса (который указан в параметре [app_code](#app-code-param)) и назначения редиректа: Сервис | Перенаправление | Значение параметра `app_code` | Значение параметра `appmetrica_tracking_id` ----- | ----- | ----- | ----- Яндекс Go | Страница приложения Яндекс Go в магазине приложений | 3 | 1178268795219780156 Яндекс Go | Сайт [Яндекс Go](https://taxi.yandex.ru/#index) | 3 | 25395763362139037 Например, если вы хотите перенаправить пользователя, который заходит с мобильного устройства на страницу приложения Яндекс Go в магазине приложений, вам необходимо указать следующие параметры: ``` https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=yoursiteru&appmetrica_tracking_id=1178268795219780156 ``` {% note info %} - Параметры точек отправления и назначения не являются обязательными. Получить координаты для указанного пользователем адреса можно с помощью [API Геокодера](https://tech.yandex.ru/maps/geocoder/). - Не рекомендуется устанавливать ссылки в `iframe` или использовать параметр `target="_blank"`, так как некоторые браузеры могут заблокировать открытие ссылки в новом окне. - Для iOS ссылки поддерживаются в формате [Universal Links](https://developer.apple.com/ios/universal-links/). {% endnote %}   ## Пример ссылки Ссылка для поездки с точкой отправления `Москва, улица Льва Толстого, 16` и точкой назначения `Москва, улица Малая Дмитровка, 6` для сервиса Яндекс Go выглядит следующим образом: ``` https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=mywebsiteru&appmetrica_tracking_id=1178268795219780156 ``` [*lang]: `lang` — язык ответа. Необязательный параметр. Возможные значения: - `ru` — ответ на русском языке. Значение по умолчанию. - `en` — ответ на английском языке. - `uk` — ответ на украинском языке. - `kk` — ответ на казахском языке. - `az` — ответ на азербайджанском языке. - `ka` — ответ на грузинском языке. - `hy` — ответ на армянском языке. - `ky` — ответ на киргизском языке. - `lv` — ответ на латвийском языке. - `ro` — ответ на румынском языке. - `uz` — ответ на узбекском языке. - `et` — ответ на эстонском языке. - `fr` — ответ на французском языке. [*appmetrica_tracking_id]: Идентификатор, который определяет логику редиректа. Обязательный параметр. Если у пользователя уже стоит приложения Яндекс Go, то ссылка сработает как deeplink и отправит пользователя в приложение. Возможные значения зависят от сервиса (который указан в параметре [app_code](*#section_qfs_zmb_dcb)) и назначения редиректа: Сервис | Перенаправление | Значение параметра `app_code` | Значение параметра `appmetrica_tracking_id` ----- | ----- | ----- | ----- Яндекс Go | Страница приложения Яндекс Go в магазине приложений | 3 | 1178268795219780156 Яндекс Go | Сайт [Яндекс Go](https://taxi.yandex.ru/#index) | 3 | 25395763362139037   Например, если вы хотите перенаправить пользователя, который заходит с мобильного устройства на страницу приложения Яндекс Go в магазине приложений, вам необходимо указать следующие параметры: ``` https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=yoursiteru&appmetrica_tracking_id=1178268795219780156 ``` [*ref]: Идентификатор источника. В данном параметре передается идентификатор [партнерской программы](https://go.yandex/ru_ru/lp/partner-program), или, если его нет, название вашего ресурса. Значение в данном параметре должно содержать только латинские символы. Например, для ресурса mywebsite.ru можно передавать идентификатор `mywebsiteru`. [*tariffClass]: [Текстовый идентификатор тарифа](https://yandex.ru/support/taxi-distr/api/trip-info.html#trip-info__class-name-desc). Совпадает со значениями `class` в запросах к API и ответом API в поле `class_name`. Необязательный параметр. Доступен только при указании начальной или конечной точек маршрута. [*end-lon]: Долгота точки назначения. Необязательный параметр. Используется совместно с параметром `end-lat`. [*end-lat]: Широта точки назначения. Необязательный параметр. Используется совместно с параметром `end-lon`. [*start-lon]: Долгота точки отправления. Необязательный параметр. Используется совместно с параметром `start-lat`. [*start-lat]: Широта точки отправления. Необязательный параметр. Используется совместно с параметром `start-lon`. [*app_code]: Идентификатор сервиса, приложение которого необходимо открыть. Обязательный параметр. Значение параметра для приложения Яндекс Go: 3 Если на устройстве пользователя приложение не установлено, логика редиректа определяется параметром [appmetrica_tracking_id](#section_qfs_zmb_dcb).