Разработчикам: запуск навигатора 2ГИС через deeplink

Запуск

Чтобы запускать приложение 2ГИС из других приложений и с веб-страниц, используйте URL-схему dgis://

Вызов приложения 2ГИС на мобильных устройствах

iOS
Android

Чтобы запустить 2ГИС из iOS-приложения:

  1. Отправьте сообщение openURL: объекту класса UIApplication.
  2. В сообщении передайте URL, содержащий схему dgis.

[[UIApplication sharedApplication] openURL: [NSURL URLWithString:@"dgis://"]];

Если 2ГИС не установлен

Перед тем как запустить 2ГИС, стоит проверить, установлено ли приложение на устройстве. Если 2ГИС не установлен, можно открыть его страницу в App Store.

Вызовите метод canOpenURL, чтобы проверить, можно ли обработать URL.

if ([[UIApplication sharedApplication] canOpenURL:[NSURL URLWithString:@"dgis://"]]) {

//Если приложение установлено — запускаем его. 

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"dgis://"]];

} else// Если не установлено — переходим в App Store.

[[UIApplication sharedApplication] openURL:

[NSURL URLWithString:@"https://itunes.apple.com/ru/app/id481627348?mt=8"]];

}

Как построить маршрут

Если вам нужно построить маршрут, сформируйте URL следующим образом.

dgis://2gis.ru/routeSearch/rsType/<type>/from/<lon>,<lat>/to/<lon>,<lat>

  • from/<lon>,<lat> используется для задания точки старта,
  • rsType/<type> используется для задания типа транспорта,
  • to/<lon>,<lat> используется для задания точки финиша.

Используются следующие параметры:

  • type, тип данных: string. Тип маршрута: car (автомобильный маршрут), ctx (общественный транспорт). Например, если параметр type/car, то строится маршрут с использованием автомобильного транспорта.
  • lon, тип данных: float. Долгота.
  • lat, тип данных: float. Широта.

Пример URL:

dgis://2gis.ru/routeSearch/rsType/car/from/30.333494,59.947164/to/30.149939,59.849767

При открытии этой ссылки в приложении 2ГИС у вас построится маршрут из центра Санкт-Петербурга. 

Маршрут может строиться без указания начальной точки. В таком случае в качестве точки отправления подставляется текущее местоположение пользователя (если его возможно определить).

Пример URL:

dgis://2gis.ru/routeSearch/rsType/car/to/30.149939,59.849767