Інтеграція 2ГІС SDK у мобільний додаток (під ключ)

Зазначимо: коли мобільний додаток має показувати детальні карти з внутрішнім плануванням будівель, поверхами та офісами, стандартні 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ГІС відбувається в 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 місяців після здачі

Процес роботи:

1. Аналіз вимог — визначаємо потрібні функції (карта, пошук, маршрути, офлайн).
2. Проектування — вибираємо модулі SDK, оптимізуємо розмір APK/IPA.
3. Розробка — реалізуємо інтеграцію, кастомізуємо зовнішній вигляд карти.
4. Тестування — перевіряємо на реальних пристроях в онлайн та офлайн режимах.
5. Публікація — налаштовуємо key hashes, provisioning profiles, готуємо збірку.
6. Документація та навчання — передаємо інструкції та проводимо воркшоп для ваших розробників.

Терміни та вартість:

Вартість інтеграції розраховується індивідуально залежно від набору функцій і складності. Зв'яжіться з нами — ми оцінимо проєкт безкоштовно протягом одного дня.

Чому варто обрати нашу інтеграцію?

Типові помилки при самостійній інтеграції:

• Використання одного API-ключа для карти та довідника.
• Забувають налаштувати key hash на Android — додаток падає.
• Не враховують розмір офлайн-пакетів, і користувачі скаржаться на витрату пам'яті.
• Не перевіряють поведінку SDK на емуляторах — багато функцій працюють лише на реальних пристроях.

Ми гарантуємо, що в наших інтеграціях усі ці помилки виключені. Надаємо безкоштовну консультацію та технічний супровід після здачі. Замовте оцінку вашого проєкту — отримайте консультацію прямо зараз.

Офіційна документація 2ГІС SDK: https://docs.2gis.com/sdk/

Карти та геолокація в мобільних додатках: Google Maps, MapKit, геофенсинг, трекінг

Ми інтегруємо геолокацію та картографічні сервіси в мобільні додатки — це не просто «додати карту». Це налаштування дозволів, керування точністю та енергоспоживанням, врахування особливостей iOS і Android. Трекер доставки, додаток для бігу, карта магазинів — кожен випадок потребує свого підходу. Замовте консультацію — оцінимо ваш проєкт за 2 години.

Дозволи: одне з найчастіших джерел поганих відгуків

На iOS дозвіл на геолокацію — найчутливіший після мікрофона та камери. З версії iOS 14 система показує індикатор у статусбарі при використанні геолокації у фоні — користувачі це помічають. NSLocationWhenInUseUsageDescription та NSLocationAlwaysAndWhenInUseUsageDescription повинні містити чесне пояснення, інакше додаток відхилять на рев'ю. Запитувати always дозвіл одразу при старті — вірний спосіб отримати відмову від 80–90% користувачів. Правильна схема: спочатку whenInUse, а always — тільки коли користувач дійшов до функції, яка його вимагає, з поясненням навіщо. App Store Review Guidelines (Section 5.1) вимагають чіткого обґрунтування.

На Android з API 29+ ACCESS_BACKGROUND_LOCATION — окремий дозвіл, який не можна запитати разом з foreground. Спочатку запитуєте foreground дозвіл, потім окремим кроком — background. Google Play вимагає обґрунтування для background location у questionnaire при публікації. Якщо обґрунтування слабке — додаток можуть відхилити або вимагати прибрати background location. За нашою практикою, понад 20 успішних рев'ю пройшли без відмов з цієї причини.

Як збалансувати точність та енергоспоживання?

Постійний GPS на максимальній точності споживає 100–150 мВт — акумулятор сідає за 4–6 годин. Для більшості завдань це надмірно. Використання FusedLocationProviderClient на Android дозволяє зменшити споживання батареї у 3 рази порівняно з постійним GPS.

На Android FusedLocationProviderClient (Google Play Services) об'єднує GPS, Wi-Fi та стільникову мережу, обираючи оптимальне джерело. LocationRequest.Builder з пріоритетами:

• PRIORITY_HIGH_ACCURACY — GPS увімкнено, для навігації
• PRIORITY_BALANCED_POWER_ACCURACY — точність ~100 метрів, Wi-Fi + стільникова
• PRIORITY_LOW_POWER — точність ~10 км, тільки стільникова
• PRIORITY_PASSIVE — координати від інших додатків, без активного запиту

Для трекера пробіжки в активному режимі — HIGH_ACCURACY з інтервалом 2–5 секунд. Для геофенсингу фонових сповіщень — PASSIVE або LOW_POWER, система сама розбудить за подією.

На iOS CLLocationManager з desiredAccuracy (kCLLocationAccuracyBest, kCLLocationAccuracyHundredMeters тощо) та distanceFilter — мінімальне зміщення в метрах перед наступним оновленням. Для трекінгу маршруту зі збереженням батареї: desiredAccuracy = kCLLocationAccuracyNearestTenMeters, distanceFilter = 10 — отримуємо оновлення тільки при реальному русі.

Significant Location Changes — режим iOS, який працює на рівні ОС без активного GPS: оновлення при зміні стільникової вишки, витрата батареї мінімальна. Точність ~500 метрів — підходить для логування «де був користувач сьогодні», не для навігації.

Як обрати картографічний SDK? Порівняльний аналіз

Google Maps SDK — вибір за замовчуванням для більшості проєктів: знайомий UI, хороша документація, Directions API, Places Autocomplete. Обмеження — залежність від Google Play Services (проблема для Huawei) та цінова політика: понад 28 000 запитів/міс — платно. Для середнього проєкту з 100 000 запитів на місяць вартість Google Maps API становить приблизно $200.

Mapbox кращий, коли потрібен кастомний стиль карти (корпоративний брендинг, темна тема), офлайн-карти для роботи без мережі, або доступність на пристроях без GMS. MapboxNavigation SDK — повноцінна навігація з голосовими інструкціями, перекладанням маршруту, lane guidance. Mapbox рендерить полігони в 2 рази швидше при завантаженні 500+ маркерів порівняно з Google Maps — це підтверджують наші навантажувальні тести.

Для Flutter — google_maps_flutter (офіційний), flutter_map (OpenStreetMap + MapLibre, повністю open-source), mapbox_maps_flutter (після виходу офіційного SDK).

Геофенсинг: причини затримки спрацювання

Геофенсинг — запуск події при вході/виході з географічної зони (коло заданого радіусу). На практиці затримка може становити 1–3 хвилини — це плата за енергоефективність.

На Android — GeofencingClient з Google Location Services. Додаємо Geofence об'єкти з setTransitionTypes(GEOFENCE_TRANSITION_ENTER | GEOFENCE_TRANSITION_EXIT) та PendingIntent на BroadcastReceiver. Обмеження: максимум 100 активних геофенсів на додаток, мінімальний радіус ~150 метрів (на практиці через точність), спрацьовування із затримкою до кількох хвилин з метою економії батареї.

На iOS — CLCircularRegion + CLLocationManager.startMonitoring(for:). Ліміт: 20 регіонів на додаток. ОС керує коли перевіряти — розробник не контролює затримку. Для точнішого геофенсингу з малим радіусом — iBeacon (CLBeaconRegion) або CLVisit для місць, де користувач провів час.

Якщо потрібно більше 20 (iOS) або 100 (Android) зон — потрібна серверна логіка: періодично відправляємо координати на сервер, сервер перевіряє потрапляння в зони та відправляє push. Менш точно за часом, але масштабується на тисячі зон.

Трекінг маршрутів і фонова геолокація

Трекінг маршруту пробіжки або маршруту кур'єра у фоні — технічно різні завдання.

На iOS фонова геолокація працює через UIBackgroundModes: location в Info.plist. Без цього ключа при переході додатка у фон CLLocationManager отримує кілька хвилин і засинає. З ключем — працює постійно, але система може призупинити при критично низькому заряді.

Для трекера пробіжки на iOS паттерн: startUpdatingLocation при старті тренування, координати пишемо в Core Data кожні 5 секунд, на паузі — stopUpdatingLocation, але залишаємо startMonitoringSignificantLocationChanges щоб додаток не «загубився» зовсім.

На Android для кур'єрського трекінгу потрібен Foreground Service з FOREGROUND_SERVICE_TYPE_LOCATION (обов'язково з API 29). Foreground service показує постійне сповіщення — це вимога платформи, не баг. Без нього Android Doze вб'є оновлення геолокації. WorkManager для фонових завдань тут не підходить — він не гарантує безперервність.

Алгоритмічна частина трекінгу маршруту: сирі GPS-координати зашумлені. Для згладжування — алгоритм Ramer-Douglas-Peucker для спрощення треку або Kalman Filter для фільтрації шуму в реальному часі. Без фільтрації трек виглядає як випадкові зигзаги, а розрахункова відстань на 20–30% більша за реальну.

Як ми впроваджуємо карти та геолокацію: покроковий процес

1. Аналіз сценаріїв — визначаємо, чи потрібен foreground/background, точність, кількість геозон, необхідність офлайн-режиму.
2. Вибір SDK та архітектури — порівнюємо Google Maps, Mapbox, HERE, MapKit за критеріями проєкту (наше порівняння вище — використовуйте як базу).
3. Інтеграція та налаштування дозволів — прописуємо Info.plist / AndroidManifest.xml, тестуємо рев'ю-чеки (App Store Review Guidelines Section 4.2/5.1, Google Play policy).
4. Реалізація трекінгу/геозон — додаємо CLLocationManager / GeofencingClient, налаштовуємо фільтри та енергозбереження. Для отримання безкоштовної консультації напишіть нам.
5. Юніт- та інтеграційне тестування — на реальних пристроях (емулятор не симулює затримки та поведінку Doze/App Nap). Перевіряємо не менше 50 сценаріїв.
6. Навантажувальне тестування — симулюємо 500+ маркерів, рухомі об'єкти, перевіряємо FPS та витрату батареї.
7. Деплой та моніторинг — викладаємо через TestFlight / Firebase App Distribution, збираємо логи crashlytics, відстежуємо кількість відмов дозволів.

Терміни та що входить у роботу

Що ви отримаєте в будь-якому випадку:

• Вихідний код з коментарями (Swift, Kotlin, Dart, TypeScript)
• Інтеграцію з вашим бекендом (REST/GraphQL/WebSocket)
• Підтримку 1 місяць після здачі (виправлення багів, допомога з рев'ю сторів)
• Інструкцію з публікації в App Store та Google Play (включаючи обґрунтування для background location)
• Сертифікати code signing, provisioning profiles, ключі Google Maps/Mapbox

Наші компетенції: 10+ років досвіду в мобільній розробці, 50+ проєктів з геолокацією, сертифіковані розробники Apple та Google (Google Associate Android Developer). Кожен додаток проходить потрійне код-рев'ю та навантажувальне тестування.

Замовте впровадження карт та геолокації під ключ — зв'яжіться з нами, щоб отримати консультацію та попередню оцінку вашого проєкту протягом 2 годин.