Интеграция 2ГИС SDK в мобильное приложение (под ключ)

Отметим: когда мобильное приложение должно показывать детальные карты с внутренней планировкой зданий, этажами и офисами, стандартные Google Maps или Яндекс.Карты не подходят — они не содержат такой информации. 2ГИС SDK решает эту задачу, предоставляя уникальные данные: схемы этажей, точные контакты организаций, маршруты внутри зданий. Мы интегрировали его в десятках проектов и знаем все подводные камни: от правильной настройки key hashes до оптимизации офлайн-карт. Наш опыт — более 30 успешных интеграций, средняя стоимость проекта составляет от 150 000 до 400 000 ₽. Предлагаем полный цикл работ: от анализа требований до публикации в магазины. Свяжитесь с нами для бесплатной консультации.

Какие проблемы решает 2ГИС SDK?

Key hashes и provisioning profiles. На Android неправильная генерация key hash приводит к ошибке аутентификации SDK — приложение падает с DGisException. На iOS неверный provisioning profile блокирует работу пуш-уведомлений и фоновых задач. Мы автоматизируем проверку этих настроек на 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 — только когда пользователь дошёл до функции, которая его требует, с объяснением зачем.

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

Точность и энергопотребление: как не разряжать аккумулятор

Постоянный GPS на максимальной точности потребляет 100–150 мВт — аккумулятор садится за 4–6 часов. Для большинства задач это избыточно.

На 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, система сама разбудит по событию. Википедия: GPS — авторитетный источник по точности.

На iOS CLLocationManager с desiredAccuracy (kCLLocationAccuracyBest, kCLLocationAccuracyHundredMeters, etc.) и 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 запросов/мес — платно).

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).

Пример выбора: приложение с офлайн-картами и геозонами на 100+ точек

Клиент — сеть розничных магазинов. Требование: карта с offline-режимом и push-уведомлениями при входе в магазин. Выбрали Mapbox — он поддерживает загрузку регионов целиком и офлайн-геокодинг. Результат: 0 отказов из-за сети, снижение расхода батареи на 30% за счёт PASSIVE-режима.

Почему геофенсинг срабатывает с задержкой?

Геофенсинг — запуск события при входе/выходе из географической зоны (круг заданного радиуса). На практике задержка может составлять 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 часов.