Разработчикам: запуск и действия в мобильном приложении через deeplink

Запустить мобильное приложение 2ГИС и совершать действия в нём можно с помощью URL вида:

  • dgis://2gis.ru/{параметры}

  • https://2gis.ru/{параметры}

Второй способ предпочтителен, так как в случае отстуствия приложения у пользователя будет открыта веб-версия 2ГИС с этим сценарием. В первом сценарии нужно определить, установлен ли 2ГИС у пользователя, чтобы при отсутствии предложить установить приложение.

Как определить установлен ли 2ГИС у пользователя

Приложение может перехватить как полные ссылки, так и короткие вида:

Ссылка передаётся в браузер, если у приложения нет интернета, чтобы развернуть короткую ссылку. Также ссылка передаётся в браузер и в том случае, если приложение не может открыть какой-либо тип ссылки.

2ГИС не ограничивает количество запусков навигации или других сценариев при запуске по deeplink. Если вы хотите построить вместе с 2ГИС прикладной сценарий для вашего бизнеса, то мы всегда рады помочь вам. Все подробности можно прочитать на сайте dev.2gis.ru.

Поддерживаемые сценарии

Открытие приложения

Действие Сценарии Пример ссылки Параметры
Открытие приложения по ссылке Запуск приложения

dgis://

https://2gis.ru/

нет

Открытие поиска

Действие Сценарии Пример ссылки Параметры

Результаты поиска

Запустить поиск и показать результаты по поисковому запросу

https://2gis.ru/search/поесть

  • поисковый запрос

Открытие карточек

Действие Пример ссылки Параметры
Открытие карточки фирмы

https://2gis.ru/firm/70000001063199639

https://2gis.ru/firm/70000001063199639

  • город (опционален)
  • id
Открытие карточки места

https://2gis.ru/geo/141476222740947

  • город (опционален)
  • id
Открытие карточки произвольного места на карте

https://2gis.ru/geo/82.683276,55.001485

  • город (опционален)
  • координата маркера
Открытие карточки остановочной платформы

https://2gis.ru/platform/141420388155769

  • город (опционален)
  • id
Открытие карточки остановки

https://2gis.ru/stop/141523467371110

  • город (опционален)
  • id
Открытие карточки маршрута

https://2gis.ru/route/141343078744191

  • город (опционален)
  • id
Открытие карточки входа в метро

https://2gis.ru/stationEntrance/141643761879195

  • город (опционален)
  • id

Избранное

Действие Пример ссылки Параметры
Открыть экран Избранного

https://2gis.ru/collections

Поиск проезда

Действие Сценарии Пример ссылки Параметры

Экран поиска проезда с пустыми полями точек А и Б

Точка А может быть заполнена местоположением пользователя, если оно будет определено

На авто:

  • https://2gis.ru/directions/tab/car
  • https://2gis.ru/moscow/directions/tab/car

Пешком:

  • https://2gis.ru/directions/tab/pedestrian

На общественном транспорте:

  • https://2gis.ru/directions/tab/bus

На велосипеде:

  • https://2gis.ru/directions/tab/bicycle

На самокате:

  • https://2gis.ru/directions/tab/scooter

На такси:

  • https://2gis.ru/directions/tab/taxi

На грузовике:

  • https://2gis.ru/directions/tab/truck

https://2gis.ru/directions/tab/[route_type]

  • город (опционален)
  • [route_type] = car/bus/taxi/pedestrian/bicycle/scooter/truck

Построение маршрута (legacy) →

Этот формат использовался в приложениях 2ГИС до 2020 года.

Действие Сценарии Пример ссылки Параметры

Маршруты

Если нет параметра «Тип проезда», то открыть экран ПП на том типе, что выбран у пользователя.

Точка А может быть заполнена местоположением, если определено.

Маршруты по типам:

На автомобиле:

https://2gis.ru/novosibirsk/routeSearch/rsType/car/from/(длинная-длинная-ссылка)

https://2gis.ru/novosibirsk/routeSearch/rsType/car/from/83.057638,54.844633/to/83.092277,54.867909

На общественном транспорте:

https://2gis.ru/novosibirsk/routeSearch/rsType/bus/from/(длинная-длинная-ссылка)

https://2gis.ru/novosibirsk/routeSearch/rsType/bus/from/83.057638,54.844633/to/83.092277,54.867909

Пешком

https://2gis.ru/novosibirsk/routeSearch/rsType/pedestrian/from/(длинная-длинная-ссылка)

https://2gis.ru/novosibirsk/routeSearch/rsType/pedestrian/from/83.057638,54.844633/to/83.092277,54.867909

На такси

https://2gis.ru/novosibirsk/routeSearch/rsType/taxi/from/(длинная-длинная-ссылка)

https://2gis.ru/novosibirsk/routeSearch/rsType/taxi/from/83.057638,54.844633/to/83.092277,54.867909

https://2gis.ru/[city]/routeSearch/rsType/[route_type]/from/[from]/to/[to]

  • проект
  • тип (необязательный)

    [route_type] = car/bus/taxi/pedestrian

  • Точки А [from] и Б [to] состоят из нескольких объектов, разделенных символом «╎»:

    [from/to] = [lon],[lat]╎[adress_string]╎[object_id]

    Обязательными параметрами старта и финиша является координата. Остальные параметры можно опустить, главное — оставить оба символа «╎»

Построение маршрута (актуально)

Действие Сценарии Пример ссылки Параметры

Построение маршрута до указанной точки

Если нет параметра «Тип проезда», то открыть экран ПП на том типе, что выбран у пользователя.

Точка А может быть заполнена местоположением, если определено.

На авто, заданы точки А и Б:

https://2gis.ru/directions/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

На авто, только точка Б (построение от текущей локации пользователя):

https://2gis.ru/directions/points/|37.665247,55.759725;4504127912651411

https://2gis.ru/directions/tab/points/37.617774,55.755836;4504222397630173|37.611407,55.713205;4504209512726602|37.6198,55.74028;4504127908465345|37.602755,55.730923;4504127908547616

На автобусе:

https://2gis.ru/directions/tab/bus/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

Пешком:

https://2gis.ru/directions/tab/pedestrian/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

На велосипеде:

https://2gis.ru/directions/tab/bicycle/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

На самокате:

https://2gis.ru/directions/tab/scooter/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

На такси:

https://2gis.ru/directions/tab/taxi/points/37.531542,55.736291;70000001063199639|37.665247,55.759725;4504127912651411

На грузовике с промежуточными точками:

https://2gis.ru/directions/points/37.617774,55.755836;4504222397630173|37.611407,55.713205;4504209512726602|37.6198,55.74028;4504127908465345|37.602755,55.730923;4504127908547616

https:// /[city]/directions/tab/[route_type]/points/[from]|[to]

  • Город [city] (необязательный)

  • Тип (необязательный, по умолчанию равен car)

    [route_type] = car | bus | pedestrian | bicycle | scooter | truck | taxi

  • Точка А [from] (необязательный — в таком случае формат будет таким: points/ | [to])

  • Точка Б [to]. Обязательными параметр точки [to] являются координаты точки, object_id можно опустить

  • Состоят из нескольких объектов, разделенных символом «;» [from/to] = [lon],[lat];[object_id]

  • Для Android есть возможность задания промежуточных точек, в таком случае между [from] и [to] через разделитель | добавляется до 10 промежуточных точек в том же формате:

    https:// /[city]/directions/tab/[route_type]/points/[from]|[point1]|[point2]|[to]

Запуск ведения по маршруту

Действие Сценарии Пример ссылки Параметры

Сразу запустить Автомобильный или Пешеходный навигатор

Если нет параметра «Тип проезда», то открыть экран ПП на том типе, что выбран у пользователя.

Точка А может быть заполнена местоположением, если определено.

Запуск навигатора:

https://2gis.ru/routeSearch/to/82.808814,54.989664/go

Запуск пешего ведения:

https://2gis.ru/routeSearch/rsType/pedestrian/to/82.808814,54.989664/go

  • проект (необязательный)

  • тип (необязательный)

  • [route_type] = car/pedestrian

  • Если тип не указан или указан bus/taxi, то запустится автомобильный навигатор.

  • Если указан pedestrian, то запустится пешее ведение.

  • точка Б (обязательный)

  • точка А (необязательный) — бессмысленный параметр, т.к. ведение по маршруту всегда запускается от текущей геопозиции

  • Команда /go (обязательная)

  • /go может необязательно стоять в конце URL, но не может находиться до routeSearch. /go не может разрывать составной токен (например, не может быть между rsType и car).