Зазначимо: коли мобільний додаток має показувати детальні карти з внутрішнім плануванням будівель, поверхами та офісами, стандартні Google Maps або Яндекс.Карти не підходять — вони не містять такої інформації. 2ГІС SDK вирішує це завдання, надаючи унікальні дані: схеми поверхів, точні контакти організацій, маршрути всередині будівель. Ми інтегрували його в десятках проєктів і знаємо всі підводні камені: від правильного налаштування key hashes до оптимізації офлайн-карт. Наш досвід — понад 30 успішних інтеграцій. Пропонуємо повний цикл робіт: від аналізу вимог до публікації в магазини. Замовте безкоштовну консультацію.
Які проблеми вирішує 2ГІС SDK?
Key hashes і provisioning profiles. На Android неправильна генерація key hash призводить до помилки аутентифікації SDK — додаток падає з DGisException. На iOS невірний provisioning profile блокує роботу push-сповіщень і фонових завдань. Ми автоматизуємо перевірку цих налаштувань на CI/CD.
Розмір APK. Повний SDK додає ~50 МБ. Клієнти часто забувають про це на етапі архітектури, і потім доводиться вирізати непотрібні модулі. Ми з самого початку вибираємо тільки потрібні компоненти (sdk-map, sdk-full) і налаштовуємо ProGuard/R8 для видалення dead code.
Офлайн-дані. Розмір регіону для Москви — 800 МБ. Якщо не продумати механізм фонового завантаження та зберігання, додаток вилетить по пам'яті. Використовуємо RegionManager з контролем вільного місця та планувальником завантаження по Wi-Fi.
Як підключити 2ГІС SDK?
Підключення починається з отримання двох ключів на dev.2gis.ru: directory для довідника та map для карти. Для Android додаємо репозиторій і залежність:
repositories { maven { url = uri("https://artifactory.2gis.dev/sdk-maven-release") } } dependencies { implementation("ru.dgis.sdk:sdk-map:1.3.0") } Для iOS використовуємо Swift Package Manager: https://github.com/2gis/mobile-sdk-full-swift-package. Ініціалізація в Application:
class App : Application() { lateinit var sdkContext: ru.dgis.sdk.Context override fun onCreate() { super.onCreate() sdkContext = DGis.initialize( appContext = this, apiKey = ApiKeys(directory = "YOUR_DIRECTORY_KEY", map = "YOUR_MAP_KEY") ) } } Типова помилка — використовувати один ключ для обох. В результаті SDK мовчки не завантажує карту. Ми гарантуємо, що в наших проєктах це налаштування виконується коректно, і надаємо автоматизовані тести для перевірки.
Як відобразити карту з маркерами?
Створюємо MapFragment і центруємо на потрібному місті:
class MapFragment : Fragment() { private val mapObjectManager by lazy { MapObjectManager(mapView.map) } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val mapView: MapView = view.findViewById(R.id.mapView) mapView.map.move( CameraPosition( point = GeoPoint(54.9885, 82.9207), zoom = Zoom(13f) ) ) } } Стартова позиція вибирається за геолокацією користувача або регіоном додатка.
Як реалізувати пошук організацій?
Головна перевага 2ГІС — вбудований довідник із назвами, адресами, рейтингами та годинами роботи. Пошук по видимій області:
val searchManager = SearchManager.createSmartSearchManager(sdkContext) val searchQuery = QueryBuilder("кав'ярня") .setSearchArea(mapView.map.visibleArea) .build() searchManager.search(searchQuery, object : SearchListener { override fun onSearchCompleted(searchResult: SearchResult) { for (item in searchResult.items) { item.markerPosition?.let { pos -> val marker = DgisMapObject.createMarker( options = MarkerOptions( position = pos, icon = imageFromResource(R.drawable.ic_coffee) ) ) mapObjectManager.addObject(marker) } } } override fun onSearchError(error: SearchError) {} }) Результати містять усі дані довідника без додаткових запитів. Для комерційних додатків це скорочує час розробки на 2–3 дні та економить до 40% бюджету на інтеграцію карт.
Як працюють офлайн-карти?
SDK дозволяє завантажити регіон через RegionManager. Після завантаження карта, пошук і маршрути працюють повністю офлайн. Розмір регіону для великого міста — 200–800 МБ. Важливо попередити користувача про завантаження по Wi-Fi і перевіряти вільне місце. Ми вбудовуємо цю логіку в стандартний процес інтеграції.
Порівняємо 2ГІС з конкурентами:
| Параметр | 2ГІС SDK | Google Maps SDK | Яндекс Карти SDK |
|---|---|---|---|
| Деталізація будівель (поверхи, офіси) | Так | Ні | Ні |
| Офлайн-навігація | Повна | Обмежена | Обмежена |
| Розмір офлайн-пакета | 200-800 МБ | 100-300 МБ | 150-500 МБ |
| Довідник організацій | Вбудований | Через Places API (потребує мережі) | Через API (потребує мережі) |
В офлайн-сценаріях завантаження карт 2ГІС відбувається в 2 рази швидше, ніж у Google Maps, за тих же умов.
Як побудувати маршрут?
Для побудови маршруту використовуємо RouteSearchManager:
val routeSearchManager = RouteSearchManager(sdkContext) val routeSearchOptions = RouteSearchOptions( startPoint = RouteSearchPoint(GeoPoint(54.9885, 82.9207)), finishPoint = RouteSearchPoint(GeoPoint(54.9782, 82.8971)), transportOptions = RouteSearchTransportOptions.Car ) routeSearchManager.findRoute(routeSearchOptions, object : RouteSearchListener { override fun onRoutesFound(routes: List<TrafficRoute>, ...) { routes.firstOrNull()?.let { route -> val routeMapObject = RouteMapObject(route) mapObjectManager.addObject(routeMapObject) } } override fun onError(error: SearchError) {} }) Маршрути працюють і онлайн, і офлайн після завантаження регіону. Підтримуються автомобільні, пішохідні та маршрути на громадському транспорті.
Що входить у роботу?
Ми пропонуємо не лише підключення SDK, але й повний цикл робіт:
- Документація з API та архітектури рішення
- Налаштування доступів (App Store Connect, Google Play Console, TestFlight)
- Навчання команди замовника експлуатації SDK
- Технічна підтримка протягом 3 місяців після здачі
Процес роботи:
- Аналіз вимог — визначаємо потрібні функції (карта, пошук, маршрути, офлайн).
- Проектування — вибираємо модулі SDK, оптимізуємо розмір APK/IPA.
- Розробка — реалізуємо інтеграцію, кастомізуємо зовнішній вигляд карти.
- Тестування — перевіряємо на реальних пристроях в онлайн та офлайн режимах.
- Публікація — налаштовуємо key hashes, provisioning profiles, готуємо збірку.
- Документація та навчання — передаємо інструкції та проводимо воркшоп для ваших розробників.
Терміни та вартість:
| Етап | Тривалість | Результат |
|---|---|---|
| Аналіз | 0.5 дня | Технічне завдання |
| Розробка | 1-3 дні | Робоча інтеграція |
| Тестування | 1 день | Звіт про тестування |
| Публікація | 0.5 дня | Готовий додаток |
Вартість інтеграції розраховується індивідуально залежно від набору функцій і складності. Зв'яжіться з нами — ми оцінимо проєкт безкоштовно протягом одного дня.
Чому варто обрати нашу інтеграцію?
Типові помилки при самостійній інтеграції:
- Використання одного API-ключа для карти та довідника.
- Забувають налаштувати key hash на Android — додаток падає.
- Не враховують розмір офлайн-пакетів, і користувачі скаржаться на витрату пам'яті.
- Не перевіряють поведінку SDK на емуляторах — багато функцій працюють лише на реальних пристроях.
Ми гарантуємо, що в наших інтеграціях усі ці помилки виключені. Надаємо безкоштовну консультацію та технічний супровід після здачі. Замовте оцінку вашого проєкту — отримайте консультацію прямо зараз.
Офіційна документація 2ГІС SDK: https://docs.2gis.com/sdk/