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

Поиск проезда Навигатор Дополнительные инструменты Инструменты для компаний

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

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

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

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

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

http://go.2gis.com/6kjcs

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

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

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

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

Действие

Сценарии

Пример ссылки

Параметры

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

Запуск приложения

dgis://

https://2gis.ru/

нет

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

Действие	Сценарии	Пример ссылки	Параметры
Результаты поиска	Запустить поиск и показать результаты по поисковому запросу	https://2gis.ru/search/поесть	поисковый запрос

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

Действие	Пример ссылки	Параметры
Открытие карточки фирмы	https://2gis.ru/novosibirsk/firm/70000001063199639 https://2gis.ru/novosibirsk/moscow/firm/70000001063199639	город (опционален) id
Открытие карточки места	https://2gis.ru/novosibirsk/geo/141476222740947	город (опционален) id
Открытие карточки произвольного места на карте	https://2gis.ru/novosibirsk/geo/82.683276%2C55.001485	город (опционален) координата маркера
Открытие карточки остановочной платформы	https://2gis.ru/novosibirsk/platform/141420388155769	город (опционален) id
Открытие карточки остановки	https://2gis.ru/stop/141523467371110	город (опционален) id
Открытие карточки маршрута	https://2gis.ru/novosibirsk/route/141343078744191	город (опционален) id
Открытие карточки входа в метро	https://2gis.ru/novosibirsk/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

город (опционален)
[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%2C54.844633/to/83.092277%2C54.867909

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

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

https://2gis.ru/novosibirsk/routeSearch/rsType/bus/from/83.057638%2C54.844633/to/83.092277%2C54.867909

Пешком

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

https://2gis.ru/novosibirsk/routeSearch/rsType/pedestrian/from/83.057638%2C54.844633/to/83.092277%2C54.867909

На такси

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

https://2gis.ru/novosibirsk/routeSearch/rsType/taxi/from/83.057638%2C54.844633/to/83.092277%2C54.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%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

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

https://2gis.ru/directions/points/%7C37.665247%2C55.759725%3B4504127912651411

https://2gis.ru/directions/tab/points/37.617774%2C55.755836%3B4504222397630173%7C37.611407%2C55.713205%3B4504209512726602%7C37.6198%2C55.74028%3B4504127908465345%7C37.602755%2C55.730923%3B4504127908547616

На автобусе:

https://2gis.ru/directions/tab/bus/points/37.531542%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

Пешком:

https://2gis.ru/directions/tab/pedestrian/points/37.531542%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

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

https://2gis.ru/directions/tab/bicycle/points/37.531542%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

На самокате:

https://2gis.ru/directions/tab/scooter/points/37.531542%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

На такси:

https://2gis.ru/directions/tab/taxi/points/37.531542%2C55.736291%3B70000001063199639%7C37.665247%2C55.759725%3B4504127912651411

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

https://2gis.ru/directions/points/37.617774%2C55.755836%3B4504222397630173%7C37.611407%2C55.713205%3B4504209512726602%7C37.6198%2C55.74028%3B4504127908465345%7C37.602755%2C55.730923%3B4504127908547616

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).

Это помоглоБесполезно