Разработчикам: запуск навигатора 2ГИС через deeplink
Запуск
Чтобы запускать приложение 2ГИС из других приложений и с веб-страниц, используйте URL-схему dgis://
Вызов приложения 2ГИС на мобильных устройствах
Чтобы запустить 2ГИС из iOS-приложения:
- Отправьте сообщение openURL: объекту класса UIApplication.
- В сообщении передайте 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 (общественный транспорт), pedestrian (пеший маршрут), taxi (маршрут на такси). Например, если параметр 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