Ваше мобильное приложение использует Mapbox, но после обновления SDK на v11 карта перестала работать: MapboxMapOptions устарел, маркеры не отображаются, а офлайн-загрузка падает с ошибкой TileRegionLoadError. Мы — команда мобильных разработчиков с пятилетним опытом интеграции картографических SDK. За это время выполнили более 150 проектов по картам — от доставки до логистики. Предлагаем готовое решение под ключ: обновим код, настроим офлайн и гарантируем производительность 60 FPS даже при 10 000+ точек. Интеграция Mapbox SDK — наша специализация. Свяжитесь с нами для аудита текущей реализации.
Как интегрировать Mapbox SDK в мобильное приложение?
Интеграция Mapbox SDK v11 начинается с настройки access token. Далее создаёте MapView в layout, подключаете стиль через MapInitOptions. Базовая карта с кастомным стилем из Mapbox Studio готова за час. Если вы переходите с v10 — смотрите раздел миграции. Mapbox SDK обеспечивает высокую производительность: на Android использует Vulkan, на iOS — Metal, что даёт 60 FPS даже на устройствах средней мощности. При интеграции Mapbox SDK с тысячами точек важно выбрать правильный подход к рендерингу.
| Тип рендеринга | Производительность (10K точек) | Память | Гибкость кастомизации |
|---|---|---|---|
| PointAnnotation | ~30 FPS | Высокая | Высокая |
| GeoJSON слой | ~60 FPS | Средняя | Средняя |
Как мигрировать с v10 на v11?
Mapbox v11 — это новый SDK с другим API. Основные изменения: MapboxMap вместо MapboxMapOptions, ViewAnnotation вместо MarkerView, PointAnnotationManager вместо SymbolManager. Мы подготовили миграционный чек-лист, чтобы не пропустить ни одной детали. Например, все addMarker() нужно заменить на PointAnnotationManager. Без этого маркеры не отобразятся. При миграции мы также обновляем обработку событий камеры и переносим offline-логику на TileStore.
Миграционные изменения v10 → v11 — интеграция mapbox sdk
| Компонент v10 | Компонент v11 |
|---|---|
MapboxMapOptions |
MapView с MapInitOptions |
MarkerView |
ViewAnnotation |
SymbolManager |
PointAnnotationManager |
addMarker() |
PointAnnotationManager.annotations |
Style.Builder |
StyleURI + style.loadStyle() |
Интеграция Mapbox SDK: производительность с тысячами точек
Для 10 000+ точек PointAnnotationManager проседает по FPS. Решение — GeoJSON-слой: добавляем источник данных и рендерим через SymbolLayer или CircleLayer. Это работает в разы быстрее. Ниже пример для Android. При большом количестве точек также включаем кластеризацию через ClusterLayer — это снижает нагрузку на рендеринг. По нашим замерам, кластеризация уменьшает количество отрисовываемых элементов на 80%, что позволяет держать 60 FPS при 50 тысячах точек.
mapView.mapboxMap.loadStyle(Style.MAPBOX_STREETS) { style ->
style.addSource(
GeoJsonSource.Builder("locations-source")
.data(
"""
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [37.6173, 55.7558]
},
"properties": {
"name": "Точка А"
}
}
]
}
""".trimIndent()
)
.build()
)
style.addLayer(
SymbolLayer("locations-layer", "locations-source")
.apply {
iconImage("custom-icon")
iconSize(1.0)
textField(get("name"))
textOffset(listOf(0.0, 1.5))
}
)
}Решение для офлайн-карт
Настраиваем загрузку региона с контролем зума и прогресса. Код ниже — загрузка центра Москвы с зумом 10-16. TileStore обеспечивает надёжное кэширование и быстрый доступ к тайлам. При ошибках автоматически повторяем загрузку. По нашим данным, офлайн-тайлы занимают в среднем 50-300 МБ на регион в зависимости от зума и площади.
val offlineManager = OfflineManager()
val tileStore = TileStore.create()
val tilesetDescriptor = offlineManager.createTilesetDescriptor(
TilesetDescriptorOptions.Builder()
.styleURI(Style.MAPBOX_STREETS)
.minZoom(10)
.maxZoom(16)
.build()
)
val tileRegionLoadOptions = TileRegionLoadOptions.Builder()
.geometry(Point.fromLngLat(37.6173, 55.7558))
.descriptors(listOf(tilesetDescriptor))
.build()
tileStore.loadTileRegion(
"moscow-center",
tileRegionLoadOptions,
{ progress ->
Log.d("Mapbox", "Downloaded: ${progress.completedResourceCount}/${progress.requiredResourceCount}")
},
{ result ->
result.fold(
{ region ->
Log.d("Mapbox", "Done: ${region.id}")
},
{ error ->
}
)
}
)Типичные ошибки при интеграции Mapbox SDK
- Неправильный access token (проверьте scope — он должен включать "Maps" и "Offline").
- Отсутствие разрешений на местоположение для точного позиционирования.
- Ошибки стиля: ссылки на отсутствующие спрайты или иконки в Mapbox Studio.
- Проблемы с кэшированием: если не очистить старый кэш после миграции, офлайн может не работать.
Процесс работы
- Анализ — изучаем текущую реализацию, определяем необходимые изменения. Проверяем версию SDK, стили, источники данных.
- Проектирование — выбираем версию SDK (рекомендуем v11), стиль, источники данных, планируем офлайн-регионы.
- Реализация — кодинг на Swift/Kotlin, настройка стилей в Mapbox Studio, тестовый access token.
- Тестирование — проверка на устройствах, нагрузочное тестирование офлайна, отладка через Android Studio / Xcode.
- Деплой — обновляем provisioning profile, публикуем в сторах.
Сроки и стоимость
Базовая карта с кастомным стилем — 1 день. Добавление GeoJSON-слоёв и офлайна — 2–3 дня. Сложные проекты с кластеризацией и кастомной навигацией — до недели. Стоимость рассчитывается индивидуально после быстрой оценки. При этом вы экономите время на самостоятельное изучение API и отладку — по нашему опыту, это до 40% времени разработки.
Что входит в работу
- Исходный код с комментариями и архитектурными пояснениями.
- Документация по настройке access token, билду и деплою.
- Доступ к стилям в Mapbox Studio.
- Поддержка при публикации в App Store и Google Play.
- Гарантия стабильной работы в течение месяца.
Оценим ваш проект за 1 день — свяжитесь с нами для консультации. Получите аудит текущей реализации и рекомендации по миграции. А ещё мы даём расширенную гарантию на интеграцию Mapbox SDK — полная поддержка в течение 30 дней после сдачи. Закажите интеграцию уже сегодня.
