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

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

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

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

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

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

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

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

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

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

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

dgis://

https://2gis.ru/

нет

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

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

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

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

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

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

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

Результаты поиска, товарная выдача

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

https://2gis.ru/novosibirsk/search/дрель/tab/market

https://2gis.ru/search/дрель/tab/market

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

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

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

https://2gis.ru/novosibirsk/firm/141265769367506

  • проект
  • id
Открытие карточки места

https://2gis.ru/novosibirsk/geo/141476222740947%2C82.916887%2C55.03122

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

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

https://2gis.ru/novosibirsk/geo/82.604141%2C55.025661

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

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

  • проект
  • id
Открытие карточки остановки

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

  • проект
  • id
Открытие карточки маршрута

https://2gis.ru/novosibirsk/route/141343122772662

  • проект
  • id
Открытие карточки входа в метро

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

  • проект
  • id

Избранное

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

https://2gis.ru/novosibirsk/myFavorites

https://2gis.ru/myFavorites

  • проект

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

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

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

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

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

  • https://2gis.ru/novosibirsk/routeSearch?queryState=routeTab
  • https://2gis.ru/routeSearch?queryState=routeTab

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

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

  • https://2gis.ru/novosibirsk/routeSearch/rsType/car?queryState=routeTab
  • https://2gis.ru/routeSearch/rsType/car?queryState=routeTab

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

  • https://2gis.ru/novosibirsk/routeSearch/rsType/bus?queryState=routeTab
  • https://2gis.ru/routeSearch/rsType/bus?queryState=routeTab

Пешком

  • https://2gis.ru/novosibirsk/routeSearch/rsType/pedestrian?queryState=routeTab
  • https://2gis.ru/routeSearch/rsType/pedestrian?queryState=routeTab

На такси

  • https://2gis.ru/novosibirsk/routeSearch/rsType/taxi?queryState=routeTab
  • https://2gis.ru/routeSearch/rsType/taxi?queryState=routeTab
  • проект (необязательный)
  • тип (необязательный)

    [route_type] = car/bus/taxi/pedestrian

Конкретные маршруты

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

Маршруты

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

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

https://2gis.ru/moscow/routeSearch/rsType/bus/from/37.379254,55.900027╎Москва Юровская 95 к2/╎4504235282955624/to/37.477749,55.855689╎Москва Метро Речной вокзал/╎4504385606390635

https://2gis.ru/moscow/routeSearch/rsType/bus/from/37.379254,55.900027╎Москва Юровская 95 к2/╎/to/37.477749,55.855689╎Москва Метро Речной вокзал/╎

https://2gis.ru/moscow/routeSearch/rsType/bus/from/37.379254,55.900027╎4504235282955624╎/to/37.477749,55.855689╎4504385606390635╎

https://2gis.ru/moscow/routeSearch/rsType/bus/from/37.379254,55.900027╎╎/to/37.477749,55.855689╎╎

https://2gis.ru/moscow/routeSearch/from/37.379254,55.900027╎╎/to/37.477749,55.855689╎╎

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

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

  • 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/routeSearch/to/82.808814,54.989664/go

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

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

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

    [route_type] = car/bus/taxi/pedestrian

    Если тип не указан или указан bus/taxi, то запустится навигатор.

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

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

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