Версии MapKit

Новые версии MapKit содержат улучшения и исправления проблем. Рекомендуется всегда использовать последнюю доступную версию.

Система нумерации

Номер версии MapKit состоит из трех чисел, например 3.0.0. При каждом обновлении номер версии увеличивается по следующим правилам:

  • первое число — при значительных изменениях в архитектуре библиотеки и потере совместимости на уровне API;
  • второе число — при потере обратной совместимости с предыдущими версиями на уровне приложения;
  • третье число — при выпуске новой версии с сохранением обратной совместимости.

Первые два числа образуют т. н. мажорную версию (например, 3.0), все три числа вместе — минорную версию (например, 3.0.0).

Список версий

Ниже приведен список изменений в MapKit SDK от версии к версии. В скобках указана дата выпуска соответствующей версии.
  • MapKit SDK 3.5.0 (28 февраля 2020)
    Список изменений
    Изменения в формате карты
    • Новый формат GEOJson тайлов.
    • Новый формат кастомизации. Подробнее
    Изменения в поиске
    • Удален метод Session.setSortByRank, теперь нужно использовать Session.resetSort.
    • Удален метод SearchManager.searchByOid, теперь нужно использовать SearchManager.resolveURI/searchByURI.
    • Удален метод SearchManager.suggest, теперь нужно использовать SearchManager.createSuggestSession.
    • Удалены методы SearchLayer.resolveURI и SearchLayer.searchByOid, остался только SearchLayer.searchByURI.
    • Удален SearchManagerType.DEFAULT, вместо него нужно использовать COMBINED (недоступен в бесплатной версии).
    Новые возможности поиска:
    • Возможность запрашивать сниппет с товарами (Snippet.GOODS1X) и получать полный список товаров для организации (SearchManager.requestGoodsRegister).
    • Возможность создавать несколько поисковых слоёв.
    Другие изменения в поисковых запросах:
    • Поисковый слой больше не запрашивает сниппеты самостоятельно, все сниппеты нужно явно задавать в опциях.
    • Поправлена ошибка с неверным пересчётом состояния пинов в поисковом слое после первого движения карты.
    • Улучшена производительность поискового слоя на слабых устройствах.
    Прочие изменения
    • Исправлен ряд ошибок в фоне и при деинициализции на iOS.
    • Улучшена работа MapKit c сетью.
    • Для коммерческих пользователей: ряд улучшений в offline cache, теперь offline карты обновляются чаще.
  • MapKit SDK 3.4.0 (2 августа 2019)
    Список изменений

    Добавлено:

    • Поддержка кластеризации.
    • Возможность создавать UserLocationLayer с помощью MapKit, аналогично другим слоям.

    Исправлено:

    • Улучшена производительность на arm64.
    • Большое количество проблем, приводящих к прекращению работы приложения.
  • MapKit SDK 3.3.1 (11 февраля 2019)
    Список изменений

    Добавлено:

    • Поддержка пользовательских GeoJSON.
    • Поддержка зума в определенную точку.
    • Возможность добавить метки с одинаковым изображением и стилем иконки одним вызовом метода mapObjects.addPlacemarks.

    Изменено:

    • На платформе Android, MapView теперь реализует интерфейс ComponentCallbacks2. Благодаря этому больше не нужно обрабатывать событие onMemoryWarning.
    • Для улучшения работы с оффлайн картами переработан OfflineCacheManager.

    Исправлено:

    • Улучшена производительность карты.
    • Уменьшено время работы на UI потоке.
  • MapKit SDK 3.2 (7 декабря 2018)
    Список изменений

    Исправлено:

    • Ошибка при работе с MapObject на карте.
    • Ошибка ContextLost при работе на эмуляторе.
    • Ошибка GL_OUT_OF_MEMORY в com.yandex.runtime.view.internal.PlatformViewBinding.onRender.
    • Ошибка при работе с локальным кэшем в оффлайн режиме при наличии обновлений.
    • Ряд сбоев в приложении при работе с картой.
    • Исчезающие при нажатии пины в поисковом слое.
  • MapKit SDK 3.1.2 (1 ноября 2018)
    Список изменений

    Исправлено:

    • Улучшена производительность карты.
    • Улучшена работа LocationPreprocessor.
    • Исправлен сбой при использовании urlProvider.
    • Устранена возможность блокировки приложения при обновлении пробок.
  • MapKit SDK 3.1 (17 октября 2018)
    Список изменений

    Добавлено:

    • Для Android появились arm64 и x86 сборки.
    • На карту можно добавить любой объект View.
    • Появилась веломаршрутизация.
    • Добавлены аннотации nullable для Android.

    Изменено:

    • MapKit разбит на части:
      • MapKit — только карта;
      • MapKit Directions — автомобильная маршрутизация;
      • MapKit Transport — пешеходная маршрутизация, маршрутизация с использованием общественного транспорта и велосипедная маршрутизация;
      • MapKit Search — поиск и геокодирование;
      • MapKit Places — панорамы.
    • Для iOS аннотации nullable стали более строгими.

    Исправлено:

    • Исправлен ряд ошибок.
    • Улучшена производительность.
  • MapKit SDK 3.0 — архивная версия (15 марта 2018)

Поддерживаемые платформы

Для стабильной работы MapKit требуется:

  • Android 4.0.3 (API Level 15) или выше;
  • iOS 9 или выше.