Версии JavaScript API

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

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

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

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

Поддерживаемые версии

В настоящий момент поддерживаются четыре мажорные версии JS API Яндекс.Карт:

  • 1.0 (последний минорный релиз 1.0.8) — архивная версия;
  • 1.1 (последний минорный релиз 1.1.21) — архивная версия;
  • 2.0 (последний минорный релиз 2.0.45) — архивная версия;
  • 2.1 — актуальная версия.

Архивные версии API продолжают поддерживаться, но не развиваются — т. е. в них исправляются критические ошибки, но не добавляется новая функциональность, в т. ч. поддержка новых веб-технологий.

Версия 2.1 в настоящий момент поддерживается и развивается. Список доступных минорных версий приведен в конце раздела.

Жизненный цикл версий

Примерно раз в месяц выпускается новая минорная версия текущей мажорной версии. Жизненный цикл минорной версии состоит из следующих этапов:

  1. Релиз-кандидат

    Первое время после релиза минорная версия является релиз-кандидатом, то есть она доступна для открытого использования, но еще находится на стадии утверждения. Релиз-кандидат содержит последние исправления и новую функциональность API, но использование релиз-кандидата в своих проектах не гарантирует стабильную работу. Как подключить релиз-кандидат

  2. Текущая версия (последняя стабильная версия)

    Если спустя некоторое время после выпуска в релиз-кандидате не было выявлено ошибок функциональности, то релиз-кандидат признается стабильным и устанавливается как текущая минорная версия соответствующей мажорной версии. Текущая версия может не содержать последние изменения в API (так как уже может быть выпущен следующий релиз-кандидат), но гарантирует стабильную функциональность. Как подключить текущую версию

  3. Фиксированная версия

    Как только следующий релиз-кандидат будет установлен как стабильный, предыдущая стабильная версия замораживается и устанавливается как фиксированная. Фиксированные версии доступны продолжительное время, но со временем они удаляются и заменяются ссылкой на текущую версию API. Как подключить фиксированную версию

Для каждой версии API в документации существуют отдельные справочники:

  • Справочник для релиз-кандидата публикуется сразу после релиза версии и доступен в разделе «Справочник JavaScript API». Когда релизная версия будет установлена как стабильная версия, соответствующий раздел со справочником удаляется из документации.
  • Справочник для текущей версии всегда доступен в разделе «Справочник JavaScript API».
  • Справочники для фиксированных версий доступны только в PDF-формате и приведены в конце данной страницы.
  • Справочник для браузера IE8 (доступен только в PDF-версии). Подробнее

Варианты подключения

Ниже приведены рекомендации по подключению и использованию версий API.

Подключение релиз-кандидата

Релиз-кандидат — это версия API, которая доступна для открытого использования, но находится на стадии утверждения. Прежде чем релиз-кандидат будет установлен как стабильная версия, первое время после выпуска он тестируется на наличие ошибок, которые могут привести к деградации функциональности API. Используя релиз-кандидат в своих проектах, вы поможете нам своевременно выявить возможные ошибки. Кроме того, вы сможете заранее протестировать работу приложения с новой версией API.

Релиз-кандидат следует использовать в среде разработки и тестирования приложения. Это позволит избежать появления ошибок в рабочем окружении. Подключить релиз-кандидат можно следующим образом:

<script src="https://api-maps.yandex.ru/2.1-dev/?lang=ru_RU" type="text/javascript"/>
Примечание. Если при подключении новой версии API вы обнаружили какие-либо ошибки, пожалуйста, сообщите об этом нам. Это можно сделать в клубе API Карт или через форму обратной связи.

Если через некоторое время после публикации релиз-кандидата не было выявлено ошибок, приводящих к деградации функциональности, релиз-кандидат устанавливается как стабильная версия API и становится доступным по ссылке api-maps.yandex.ru/2.1.

Подключение текущей версии

При эксплуатации приложения рекомендуется указывать мажорную версию (т. е. не указывать третье число версии). В этом случае будет автоматически подключена текущая версия, то есть последняя стабильная версия соответствующей мажорной версии. Так, например, если указана версия 2.1, то будет подключена последняя стабильная на данный момент версия 2.1.x (например, 2.1.47):

<script src="https://api-maps.yandex.ru/2.1/?lang=ru_RU" type="text/javascript"/>

Подключение фиксированной версии

Хотя между минорными версиями гарантируется полная совместимость, в редких случаях может оказаться, что ваше приложение при подключении последней версии API не работает так, как было задумано. Поэтому для предотвращения таких ситуаций, в особо ответственных случаях, может потребоваться подключить строго определенную версию API. Для этого нужно указать ее номер целиком:
<script src="https://api-maps.yandex.ru/2.1.44/?lang=ru_RU" type="text/javascript"/>
Примечание. Если вы используете фиксированную версию, старайтесь регулярно переключать ее на более свежую версию (например, раз в несколько месяцев). Дело в том, что со временем мы можем отключить минорную версию, которую вы используете в своем проекте, и тогда у вас автоматически подключится текущая версия API. Но может оказаться, что при смене версий ваше приложение стало работать некорректно. Поэтому мы рекомендуем следить за обновлениями API и своевременно переключаться на более свежие версии.

Сводная таблица

Ниже приведена сводная таблица, содержащая рекомендации по подключению разных версий API в зависимости от типа и сложности проекта.

Тип проекта Рекомендуемая версия при эксплуатации приложения Рекомендуемая версия в разработке

Небольшие проекты

Конструктор карт.

Конструктор карт.

Средние и крупные проекты, с простой картой

Последняя версия api-maps.yandex.ru/2.1.

Релиз-кандидат версия api-maps.yandex.ru/2.1-dev для проверки функциональности.

Средние и крупные проекты, со сложной функциональностью карты

Фиксированная версия api-maps.yandex.ru/2.1.x (см. примечание ниже).

Релиз-кандидат версия api-maps.yandex.ru/2.1-dev для проверки функциональности.

Проекты, использующие платную версию API

Фиксированная версия enterprise.api-maps.yandex.ru/2.1.x (см. примечание ниже). Фиксированная версия enterprise.api-maps.yandex.ru/2.1.x (см. примечание ниже)
Примечание. Если вы используете фиксированную версию, старайтесь регулярно переключать ее на более свежую версию. Дело в том, что со временем мы можем отключить минорную версию, которую вы используете в приложении, и тогда у вас автоматически подключится текущая версия API. Но может оказаться, что при смене версий ваше приложение стало работать некорректно. Поэтому рекомендуется следить за обновлениями API и своевременно переключаться на более свежие версии.

Совместимость с браузерами

API Яндекс.Карт корректно работает в следующих браузерах:

  • Яндекс.Браузер, включая мобильную версию;
  • Chromium и Google Chrome, включая мобильную версию;
  • Safari для Mac и iOS;
  • Mozilla Firefox;
  • Opera;
  • Microsoft Internet Explorer, включая мобильную версию при условии установки последних обновлений.

В этих браузерах доступна и работает полностью одинаково вся функциональность API Яндекс.Карт.

Частично поддерживаются следующие браузеры:

  • Microsoft Internet Explorer версий 8-10;
  • Opera версии 12;
  • AndroidBrowser версий 4.0+.

В этих браузерах доступна та функциональность API Яндекс.Карт, которую технически возможно реализовать на данной платформе. Например, в IE8 не поддерживается задание произвольных цветов меток в силу отсутствия полноценной поддержки SVG этим браузером. Кроме того, внешний вид графических объектов и элементов управления может отличаться в разных браузерах.

Внимание.

Для пользователей, которые работают в браузерах IE8, IE9 и IE10, будет подключаться версия 2.1.oldie.1 (даже если в ссылке подключения указана другая версия API). Версия 2.1.oldie.1 функционально соответствует версии 2.1.59 и не содержит более поздних обновлений.

Если необходимо поддерживать браузеры IE8, IE9 и IE10, при написании кода ориентируйтесь на справочник версии 2.1.59 (скачать справочник). Использование функциональности более поздних версий может привести к некорректной работе API в IE8, IE9 и IE10.

Корректная работа API в браузерах, функционирующих в режиме совместимости со старыми версиями (Quirks mode) не гарантируется.

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

Ниже приведен список изменений в JavaScript API Яндекс.Карт от версии к версии. В скобках указана дата выпуска соответствующей версии.

  • JSAPI 2.1.66 — релиз-кандидат (17 июля 2018 г)
    Список изменений

    Исправлено:

    • Для некоторых маркеров POI активная область не совпадала с подложкой.
  • JSAPI 2.1.65 — текущая версия (14 июня 2018 г)
    Список изменений

    Добавлено:

    • Тип маршрутов «Такси» в панели маршрутов.
    • Информация об ограничениях по ходу движения в балуне маршрута.
    • Метод 'getTileStatus()' тайлового слоя, который возвращет статус загрузки тайлов подложки.
    • В данные сервиса Регионы добавлена информация о граничащих регионах для каждого объекта.

    Исправлено:

    • Метод 'getAllPoints()' модели мультимаршрута не возвращал via-точки, если маршрут не удалось построить.
    • Карта иногда не загружалась после масштабирования через Pinch-to-Zoom на iOS.
    • Обновление Геоссылки при изменении контента страницы.
    • Геоссылка неверно определяла цвет фона при выборе цвета текста.
    • Оптимизация загрузки API.
    • Правки вёрстки.
  • JSAPI 2.1.64 (24 апреля 2018 г) Скачать справочник
    Список изменений

    Исправлено:

    • Отображение тайлов карты в Яндекс.Браузере для ОС Windows.
  • JSAPI 2.1.63 (17 апреля 2018 г) Скачать справочник
    Список изменений

    Изменено:

    • Дизайн блока «Открыть в Яндекс.Картах» плеера панорам.
    • Добавлена проверка API-ключа, если он указан при подключении бесплатной версии API. Если передан действующий ключ коммерческой версии, засчитывается статистика.

    Исправлено:

    • Опция панели маршрутов 'autofocus: false' не срабатывала, если уже задана начальная или конечная точка маршрута.
    • При зуме в мобильном Safari иногда приходило лишнее событие 'actionbegin'.
    • Признак 'viaPointsChange' в событии 'requestsuccess' принимал неправильное значение при драге via-точек маршрута.
    • Правки верстки.
  • JSAPI 2.1.62 (21 марта 2018 г) Скачать справочник
    Список изменений

    Добавлено:

    • Новая версия модуля Регионы, которая использует данные о границах от Яндекса, возвращает GeoJSON и может использоваться с менеджерами объектов.
    • Опция панели маршрутов 'autofocus' для выключения автофокуса в поле ввода панели маршрутов.

    Изменено:

    • Карта автоматически центрируется на точке маршрута при ее заполнении через панель маршрутов.

    Исправлено:

    • ObjectManager работал некорректно при добавлении объектов с разными типами id.
    • Ссылки на Яндекс.Карты иногда включали лишние параметры.
    • Точка маршрута не удалялась с карты при удалении запроса в панели маршрутов.
    • Неправильно отображался курсор рисования маршрута при работе API в режиме CSP.
    • Иногда уровень зума тайлов в плеере панорам выбирался неправильно.
    • Правки верстки.
  • JSAPI 2.1.60 (11 января 2018 г) Скачать справочник
    Список изменений

    Исправлено:

    • Отображение панорам на устройствах под управлением macOS.
    • Оптимизация загрузки API.
  • JSAPI 2.1.59 (14 декабря 2017 г) Скачать справочник
    Список изменений

    Добавлено:

    • Методы 'open()' и 'close()' балуна мультимаршрута и соответствующие им события.
    • В метод 'openPlayer()' менеджера Панорам можно передать направление взгляда.
    • Маркеры транспортных объектов на подложке стали интерактивными. По клику открывается карточка объекта.
    • При автоматическом исправлении поискового запроса теперь можно повторить поиск по оригинальному запросу.
    • Блок "Открыть в Яндекс.Картах" появился в балунах результатов поиска для провайдера 'yandex#map'.

    Изменено:

    • Отключены ограничения географии поиска и маршрутизации в коммерческой версии.
    • Провайдер поиска 'yandex#search' стал доступен для использования в коммерческой версии.
    • Нитка маршрута стала более заметной при включенном слое панорам.

    Исправлено:

    • В 'objectManager' происходило переполнение стека при 'gridSize' равном 256.
    • Падала ошибка при удалении панели маршрутизации.
    • Происходило лишнее автопозиционирование карты при использовании линейки на карте с менеджером отступов.
    • Опция 'suppressMapOpenBlock' не срабатывала, если плеер панорам открыт кликом на слой панорам подложки.
    • Правки верстки.
  • JSAPI 2.1.56 (10 октября 2017 г) Скачать справочник
    Список изменений

    Добавлено:

    • Новый контрол панели маршрутизации для добавления несворачиваемой панели на карту.
    • Возможность настройки видов транспорта доступных в панели маршрутизации.
    • Метод 'routePanel.geolocate()' для заполнения точек маршрута местоположением пользователя.
    • Пресеты меток с новыми иконками.

    Изменено:

    • Свойство iconCaption теперь можно задать для большинства пресетов меток.

    Исправлено:

    • В событиях marker* плеера панорам возвращалась неправильная сущность в поле marker.
    • Блок "Открыть в Яндекс.Картах" отображался на картах в нестандартных проекциях.
    • При программном заполнении точки в панели маршрута в нем оставался фокус ввода.
    • Не работала опция 'interactiveZIndex' менеджера объектов.
    • Правки верстки.
  • JSAPI 2.1.55 (10 августа 2017 г) Скачать справочник
    Список изменений

    Исправлено:

    • Не работали метки с макетом pieChart.
    • Ошибки при включении панели маршрутов при активном редакторе маршрута на карте.
  • JSAPI 2.1.54 (08 августа 2017 г) Скачать справочник
    Список изменений

    Добавлено:

    • Новый элемент управления для построения маршрута с панелью выбора начальной и конечной точек маршрута.
    • Опции для настройки ширины элемента управления SearchControl.
    • Методы 'zoomIn()' и 'zoomOut()' плеера панорам.
    • События 'markermouseenter', 'markermouseleave','markerexpand' и 'markercollapse' маркеров панорамы.
    • Опция 'loadTileSize' менеджеров объектов RemoteObjectManager и LoadingObjectManager для указания размера загружаемых тайлов.
    • Метод 'getPanoramaManager()' для программного доступа к менеджеру панорам.

    Изменено:

    • Геоссылка теперь поддерживает указание географических координат в качестве тела ссылки.

    Исправлено:

    • Плеер панорам работал некорректно в браузерах на базе Chromium при встраивании через iframe.
    • Иногда не загружалась панорама хорошего качества после изменения зума и центра.
    • Промаргивал курсор с точкой «А» при добавлении маршрута на карту.
    • Балун альтернативного маршрута не открывался сразу при клике на нитку маршрута.
    • Курсор рисования маршрута отображался на карте после включения слоя панорам.
    • Не закрывался попап с картой при повторном клике на Геоссылку.
    • Проблемы драга карты при размещении карты в iframe.
    • Иногда после драга карты приходило событие 'click'.
  • JSAPI 2.1.53 (11 июля 2017 г) Скачать справочник
    Список изменений

    Исправлено:

    • Работа API в webView на устройставх под управлением iOS.
  • JSAPI 2.1.52 (06 июня 2017 г) Скачать справочник
    Список изменений

    Исправлено:

    • Ошибки в режиме работы с CSP.
  • JSAPI 2.1.51 (23 мая 2017 г) Скачать справочник
    Список изменений

    Изменено:

    • Внешний вид путевых точек мультимаршрутов и курсора в режиме добавления путевых точек.

    Исправлено:

    • При построении маршрутов на общественном транспорте иконка в балуне могла не совпадать с видом транспорта на сегменте маршрута.
    • При масштабировании правой кнопки мыши в режиме просмотра панорам на миникарте не отображалась область выделения.
    • Не работала линейка при включенном слое панорам.
    • Метод 'getObjectInPosition()' слоя активных областей не всегда округлял дробный зум при запросах за тайлами.
    • При поиске по организациям иногда автоматически открывалась карточка объекта, если в видимой области карты находился только один результат.
    • Карта в Геоссылке не учитывала локаль подключения API.
    • При ошибке в Геоссылке выводилось пустое описание.
    • В карточках POI домов не отображался адрес.
    • При масштабировании панорам на iOS иногда происходила ошибка рендеринга.
    • Маркеры POI на подложке могли быть неинтерактивны.
    • При некоторых неверных запросах API отвечал статусом 500 вместо 400.
    • Ошибка метода 'removeAll()' коллекции в случае, когда элементы заданы по индексам.
    • Оптимизация загрузки API.
  • JSAPI 2.1.50 (04 апреля 2017 г) Скачать справочник
    Список изменений

    Исправлено:

    • Не работали панорамы в последних обновлениях Safari для macOS и iOS.
  • JSAPI 2.1.49 (30 марта 2017 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Слой панорам в 'typeSelector' можно отключить после создания элемента управления.
    • Горячие клавиши для управления направлением взгляда в плеере панорам: PageUP - вверх, PageDown - вниз (Для MacOS работают с зажатой клавишей fn).

    Изменено:

    • Имена интерфейсов связей и переходов и связанных методов с сохранением работы старых наименований.
    • При поиске по координатам через 'searchControl' метка результата поиска ставится по координатам из запроса.
    • Для пешеходных сегментов маршрута на общественном транспорте теперь отображается время пути.
    • Отображение маркера панорам на темных подложках.

    Исправлено:

    • При вызове метода 'setBounds()' в некоторых браузерах запрашивались неиспользуемые тайлы карты.
    • Контент балуна геоссылки наследовал стили страницы.
    • Ссылка «Поискать в Яндексе» в 'searchControl' для локали ru_UA вела на неправильный домен.
    • Проблемы с кодировкой в MS IE при переходе в Яндекс.Карты с заголовка карточки топонима.
    • Ошибка в слое активных областей при задании 'keyTemplate' функцией.
    • Метод 'getObjectInPosition()' нового слоя активных областей возвращал 'null' до перехода курсора к следующему тайлу.
    • Объекты слоя активных областей могли дублироваться при последовательных вызовах метода 'getObjectsInPosition()'.
    • Использование API с включенным CSP приводило к ошибкам в браузерах MS IE 8, MS IE 9 и Opera 12.
    • Не всегда правильно применялось направление взгляда при создании плеера панорам.
    • Не учитывалось значение CSS свойства 'padding' при использовании метода 'fitToViewport()' плеера панорам.
    • Оптимизированы сетевые запросы при работе с плеером панорам внутри карты при медленном интернет соединении.
    • Иногда при перетаскивании via-точек маршрута они дублировались.
    • Удаление via-точек маршрута иногда приводило к смещению других точек маршрута.
    • Падала ошибка при подключении API с параметром 'mode=release', если успеть включить пробки сразу после клика в слой панорам.
    • Ошибка отображения сложных полигонов.
    • Правки верстки.
  • JSAPI 2.1.48 (16 февраля 2017 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Слой панорам теперь доступен для выбора в переключателе типа карты. Плеер откроется аналогично Яндекс.Картам. При необходимости слой панорам в элементе управления 'typeSelector' можно отключить опцией 'panoramasItemMode'.
    • Модуль 'Geolink' для добавления в тело страницы ссылки на адрес или организацию на Яндекс.Картах со статической картой в превью.
    • Опция 'minPoints' в редакторе геометрий, определяющая минимальное возможное количество вершин геометрии.
    • Опция 'autoFitToViewport' плеера Панорам.

    Изменено:

    • Обновлен стиль элементов управления.
    • На неподдерживаемых платформах в плеере Панорам отображается сообщение для пользователя.

    Исправлено:

    • Иногда маркеры POI были неинтерактивны в Mozilla FireFox и Safari.
    • Промежуточная точка в редакторе геообъекта позиционировалась неправильно при автоперемещении карты.
    • Саджест в 'searchControl' не учитывал видимый центр карты.
    • Не открывался балун маршрута при клике на склеенные метки.
    • Не работали опции редактора ломаной 'vertexLayout' и 'edgeLayout'.
    • Блок "Открыть в Яндекс.Картах" передавал неправильный порядок координат в одном из параметров поиска.
    • Не работало перетаскивание карты на некоторых моделях WinPhone с версией ОС 8 и 8.1.
    • Метки мультимаршрута на общественном транспорте не всегда склеивались после перемещения карты.
    • Не снимался фокус с поля ввода при переходе в плеер Панорам.
    • Не работал переход между снимками в плеере Панорам с помощью клавиш одновременно с изменением угла обзора.
    • При печати страницы с плеером Панорам не печатлся логотип.
    • В некоторых системах не открывались номера домов а плеере Панорам при масштабе страницы больше 100%.
    • Оптимизация и повышение стабильности плеера Панорам.
    • Правки верстки.
  • JSAPI 2.1.47 (7 декабря 2016 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Оптимизировано перетаскивание сложных геометрий при редактировании.
  • JSAPI 2.1.46 (1 декабря 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Опция 'preventDragUpdate', позволяющая отключить автоматическое перестроение маршрута до окончания перетаскивания путевых точек.
    • Блок "Открыть в Яндекс.Картах" передает метки из коллекций.

    Изменено:

    • Обновлены карточки организаций и топонимов.
    • Блок "Открыть в Яндекс.Картах" учитывает видимую область карты при выборе передаваемых объектов.
    • При редактировании геометрий промежуточная вершина на ребре находится в видимой области карты.
    • Оптимизировали отображение геометрий с самопересечениями.
    • Опция 'yandexMapDisablePoiInteractivity' теперь позволяет включить точки POI в платной версии API.

    Исправлено:

    • Активная область точек POI на границе тайлов.
    • Опция 'routeActiveStrokeStyle' не работала для пешеходных мультимаршрутов.
    • Не срабатывала первая установка 'data.image' у элемента управления listBox.
    • Вызов 'startFraming' на редакторе полигона с пустой геометрией завершался ошибкой.
    • При драге карты одновременно с ее программным перемещением мог возникнуть конфликт.
    • При добавлении сложного полигона на карту возникали ошибки.
    • Карта могла быть спозиционирована неправильно при открытии балуна во время зума.
    • Иногда возникали проблемы с драгом в бразуерах Edge, MSIE 10, MSIE 11.
    • Появлялась ошибка при удалении карты во время редактирования геометрии.
    • Правки редактирования и отображения геометрий.
    • Правки верстки.
  • JSAPI 2.1.45 (11 октября 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Метод 'panorama.Base.getMarkerPositionFromDirection' для вычисления координат маркера по направлению на него.

    Исправлено:

    • Не срабатывал метод 'map.zoomRange.getCurrent()' и не отправлялось событие 'zoomrangechange' при использовании менеджера отступов;
    • В некоторых браузерах элемент управления масштабом Панорамы не выключался на граничных масштабах;
    • Проблемы печати Панорам в Mozilla FF;
    • Не срабатывало событие 'destroy' при нажатии клавиши 'Esc' в плеере Панорам;
    • Не открывались условия использования при попытке перехода из плеера Панорам на touch-устройствах;
    • Проблемы управления с клавиатуры в плеере Панорам.
  • JSAPI 2.1.44 (28 сентября 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Маркеры объектов на подложке карты стали интерактивными, по клику открывается карточка объекта;
    • В стандартном балуне маршрута появился умный блок "Открыть в Яндекс.Картах";
    • Макет 'layout#pieChart' для отображения меток в виде круговых диаграмм на базе собственных данных;
    • Управление с клавиатуры в плеере Панорам, включается опцией 'hotkeysEnabled';
    • Опция 'scrollZoomBehavior' для отключения масштабирования колесом мыши в плеере панорам;
    • Опция 'useAutoPanInDrawing' для отключения автоматического движения карты в режиме рисования геообъекта;
    • Опция карты 'rulerBalloonAutoPan' для отключения автоматического центрирования карты на линейке;
    • Опция карты 'yandexMapDisablePoiInteractivity' для отключения интерактивности маркеров на подложке;

    Исправлено:

    • Карта иногда не загружалась при наличии на странице также карты Конструктора или двух карт с разными значениями 'onload';
    • Проблемы инерции при перетаскивании и масштабировании карты;
    • ObjectManager не отображал пользовательские метки в Safari Mobile до взаимодействия с картой;
    • Событие 'actionend' не срабатывало в плеере Панорам;
    • Проблемы печати визуальных элементов карты в MS IE, Edge, Firefox;
    • Изображение панорамы искажалось при слишком большой ширине плеера;
    • Метка с id=0 в ObjectManager пропадала после закрытия ее балуна;
    • Иногда объекты в плеере Панорам теряли интерактивность;
    • Правки в редакторе геометрий;
    • Правки стабильности плеера Панорам;
  • JSAPI 2.1.42 (12 июля 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Поддержка панорам в Платном API.
    • Метод карты 'copyrights.getPromoLink()' для получения ссылки из блока "Открыть в Яндекс.Картах".

    Исправлено:

    • Утечки памяти при удалении карты.
    • В некоторых ситуациях не срабатывала геолокация при использовании обратного геокодирования.
    • Иногда неправильно выставлялись координаты рисуемой вершины в редакторе геометрий при одновременном прокручивании карты.
    • Метки дорожных событий теряли интерактивность в некоторых ситуациях.
    • Проблема инерции при драге карты в Mozilla Firefox на некоторых конфигурациях MacOS.
    • Центр карты выставлялся неправильно при выполнении fitToViewport во время анимации зума.
    • Пресеты с пиктограммами выглядели нечеткими в Opera12.
    • Проблемы при печати карт.
  • JSAPI 2.1.41 (7 июня 2016 г.) Скачать справочник
    Список изменений

    Изменено:

    • Продолжительность кинетического драга.

    Исправлено:

    • Зависимости сторонних модулей не разрешались через fallback.
    • Не подгружалось сообщение об ошибке в searchControl при отсутствии результатов поиска.
  • JSAPI 2.1.40 (26 мая, 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Пешеходная маршрутизация.
    • Новые пресеты меток с иконками.
    • Контекстные подсказки при поиске по организациям.
    • Поддержка опции 'autoPan' для балуна в режиме панели.

    Изменено:

    • Логика пользовательского взаимодействия с 'searchControl'.

    Исправлено:

    • В некоторых случаях не срабатывало событие 'resultHide'.
    • При вызове метода 'destroy()' карты падала ошибка в 'suggest' у 'searchControl'.
    • Не появлялось сообщение "Идет запрос к серверу" в 'searchControl'.
    • Не отображалось время работы организации в поиске, если API подключен с параметром coordorder=longlat.
    • Ошибки при использовании карты Конструктора в Angular приложении.
    • Ошибка при задании состояния линейки без карты.
    • Не отображался блок "открыть в Яндекс.Картах" в Mozilla Firefox при загрузке карты в скрытом контейнере.
    • Оптимизированы поисковые запросы.
    • Оптимизированы макеты и css.
    • Проблемы производительности тайлов в Mozilla Firefox.
  • JSAPI 2.1.39 (14 апреля 2016 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Событие 'boundschange' приходило дважды при драге с инерцией.
    • Некорректно отображалась метка при смене пресета во время работы с картой.
    • Утечка памяти в option.Manager.
  • JSAPI 2.1.38 (31 марта 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • API Панорам, предоставляющий возможность встроить на свой сайт панораму Яндекса или снятую собственноручно (запущен в beta режиме).
    • Смещение карты при приближении к ее границам в режиме рисования новых вершин в редакторе геометрий.

    Исправлено:

    • Проблема с активными областями меток кластеров в Firefox и Safari.
    • Некорректная работа карты при вызове метода `map.destroy()` во время редактирования фигуры.
    • SearchControl заменял введенные кавычки на &quot;
    • Некорректная работа редактора геометрий при использовании глобального CSS-правила 'text-align: center'.
    • Некорректная работа опции useMapMargin у route.
    • Завершалось рисование геометрии при удалении даблкликом точки линейки.
    • Переход через блок "Открыть в Яндекс.Картах" с результатом поиска по своим объектам.
    • Артефакты анимации тайлов в Firefox на дисплеях высокой четкости.
  • JSAPI 2.1.35 (18 февраля 2016 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Блок "Открыть в Яндекс.Картах" теперь передает расположение меток, маршруты, результаты поиска и другие параметры карты.
    • MarginManager для настройки отступов карты.
    • Корректор координат в редакторе точечной геометрии.
    • Возможность обращаться к полям дочерних объектов кластера из макета хинта.
    • Возможность передавать в метод 'requireCenterAndZoom' объекта 'map.ZoomRange' менеджер коэффициентов масштабирования конкретной карты.
    • Простые методы доступа к xAL результатов геокодирования.

    Изменено:

    • Логика переходов из блока "Открыть в Яндекс.Картах" на мобильных устройствах.
    • Блок "Открыть в Яндекс.Картах" теперь скрывается при печати.
    • Новый алгоритм активных областей: PR-tree.

    Исправлено:

    • KML парсер теперь правильно обрабатывает параметры ширины и высоты в опции 'iconImageSize'.
    • Отображение тайлов прогноза пробок на дисплеях Retina.
    • Улучшена производительность за счет оптимизации кэширования.
    • Загрузка внутренних скриптов API всегда происходит по HTTPS.
    • Удалена глобальная переменная 'res'.
    • При повороте фигуры одновременно со скроллом в редакторе поворота она больше не скрывается.
    • При редактировании промежуточной точки в редакторе оставалась предыдущая линия рисования.
    • При сильном уменьшении объекта в режиме редактирования он иногда отрисовывался вне рамки.
    • В режиме 'canvas' заливка 'stretch' неправильно работала для многоконтурных полигонов.
    • Некорректное отображение полигонов с внутренним контуром при расположении вблизи 180-го меридиана.
    • Исправлено поведение метода 'geocode' в случае серверной ошибки.
    • Динамическое изменение отображения меток в IE 11.
    • Верстка при указании глобального CSS-правила 'text-align: center'.
    • Верстка карточки организации в турецкой локали.
    • Проблемы с отображением карты во время масштабирования в MacOS X 10.11 в Safari.
    • Порядок добавления и отображения транзитных точек в мультимаршрутизаторе.
    • Позиционирование кластеров в менеджере объектов по оси Z.
    • Падала ошибка при двукратном вызове 'map.destroy()' при наличии линейки на карте.
    • Правки верстки в старых версиях браузеров.
  • JSAPI 2.1.34 (7 декабря 2015 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Некорректная работа с RequireJS подобными системами.
  • JSAPI 2.1.32 (25 ноября 2015 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Новый дизайн и оптимизация редактора геометрий.
    • Блок "Открыть в Яндекс.Картах" теперь поддерживает карты, созданные в Конструкторе.
    • Печать стандартных меток в Mozilla Firefox.
    • Объекты в ObjectManager поддерживают опцию zIndex.
    • Улучшена карточка организации в поиске по организациям.
    • Возможность перейти к поиску Яндекса, если SearchControl не вернул результатов (регулируется опцией suppressYandexSearch).
    • В меню редактора геообъектов появилась возможность передавать html разметку.
    • Появился метод clear() в SearchControl.
    • Оптимизирована работа фильтров в ObjectManager.
    • Оптимизирована анимация на мобильных устройствах.
    • Опцию suppressMapOpenBlock можно менять в runtime.

    Исправлено:

    • При подключении нескольких версий API с разными локалями дублировались метки.
    • Методы getOverlay() балунов и хинтов геообъектов теперь всегда возвращают promise (возможно, отклоненный, если оверлея нет).
    • Не приходило событие drawingstart при выборе пункта "Продолжить" в редакторе графики.
    • Могла возникать ошибка при переключении режима мультимаршрута с автомобильного на общественный транспорт.
    • Проблемы с двойным тапом по меткам в Android.
    • На маке при скролле тачпадом иногда происходил прыжок в обратном направлении.
    • Внутренние контуры полигонов больше не теряются при переходе между мирами.
    • После поворота полигона с внутренним контуром иногда создавалась лишняя точка.
    • Блокировалось перетаскивание карты при последовательном нажатии левой и правой кнопки мыши в MSIE10 и MSIE11 на WIN8-10.
    • Артефакты анимации в Mozilla Firefox.
    • SearchControl некорректно работал с опцией popupItemLayout.
    • Проблемы с отображением площадных объектов в MSIE.
    • В режиме редактирования было можно оторвать контекстное меню от вершины полигона.
    • Не передавались опции балуна в методе setObjectOptions() объекта objects в классе ObjectManager.
    • При поиске по организациям searchControl показывал первый результат на другом конце света, если указан &coordorder=longlat.
    • Для оверлея хинта и панели метод getShape() иногда возвращал null.
    • Использование опции clusterIconContentLayout: null.
    • Проблемы с отображением кругов, пересекающих 180 меридиан.
    • Блок "Открыть в Яндекс.Картах" теперь показывается только в географической координатной системе.
    • Приходил некорректный bounds для маршрутов, состоящих из нескольких одинаковых точек.
    • Мелкие ошибки верстки.
  • JSAPI 2.1.31 (5 ноября 2015 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Проблема с перетаскиванием точек маршрута в Microsoft Edge.
    • Проблема с жестом скролла в Chrome на MacOS.
  • JSAPI 2.1.29 (3 августа 2015 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Поддержка новых браузеров: Microsoft Edge и Firefox для Android.

    Исправлено:

    • Сдвиг координат опорных точек при построении мультимаршрутов с включенным обратным геокодированием.
    • Проблемы с событием «click» на некоторых Android-устройствах.
  • JSAPI 2.1.27 (18 июня 2015 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Ссылка «Открыть в Яндекс.Картах» в нижней части карты.
    • Ссылка «Обновите браузер» для устаревших версий браузера.
    • Класс 'Template'.

    Изменено:

    • Оптимизация RemoteObjectManager: отображение точек только в видимой области.

    Исправлено:

    • Геокодирование точек маршрутов в enterprise-версии.
    • Периодическая ошибка при построении маршрута из трех точек.
    • Оптимизирована скорость масштабирования карты на устройствах с iOS.
    • Проблемы с touch-событиями при добавлении на карту некоторых площадных геообъектов.
    • YMapsML: не устанавливался тип карты, если в MapState был bounds.
    • Неправильные размеры иконок 'masstransit' в мультимаршрутизаторе.
    • Неверное значение поля 'address' в мультимаршрутизаторе.
    • Не удалялся результат запроса в поисковом контроле после смены провайдера.
    • Кастомный провайдер для саджеста не отображал значения.
    • 'util.hd.selectValue()' не возвращал значения для дробных DPR.
    • Кластеры в RemoteObjectManager пропадали при смене зума.
    • Смещение меток при изменении масштаба страницы.
    • Некорректно работал 'editor.startDrawing()' в обработчике события geometrychange у полигона.
    • При перетаскивании маршрута не учитывался параметр searchCoordOrde`.
    • Вылетала карта в IE8, если ее инициализировать в скрытом контейнере.
    • Проблемы с отображением графики при масштабировании в IE 8-9 и Opera 12.
  • JSAPI 2.1.26 (27 мая 2015 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Автоперемещение карты при приближении к границе во время рисования и редактирования объектов.
    • Печать карты в Firefox.
    • Модуль 'util.hd' для работы с экранами с высоким разрешением.
    • Модуль 'util.bounds' для работы с границами и их пересечениями.
    • Модуль 'event.Mapper' для управления распространением событий.
    • Модуль 'ymaps.meta', содержащий параметры API и данные окружения.
    • Модуль 'util.requireCenterAndZoom' для расчета оптимального центра и масштаба для отображения карты с заданными границами.
    • Поддержка поля 'AddressDetails' в поиске по организациям.

    Изменено:

    • Расширен интерфейс метода 'ready', позволяющий теперь загрузить дополнительные модули.
    • Оптимизирована плавность и отзывчивость действий карты.
    • Оптимизирована начальная загрузка необходимых модулей.
    • Оптимизировано масштабирование карты на мобильных устройствах.
    • Оптимизирована работа поведения карты 'dblClickZoom'.
    • Плавная прокрутка элементов с 'overflow: auto' в iOS.
    • Геокодирование точек маршрута теперь происходит на клиенте.

    Исправлено:

    • Удалены глобальные CSS-правила 'box-sizing', которые могли влиять на пользовательские элементы.
    • Исправлена работа метода 'getClosest' в геометриях.
    • Верстка тянущейся иконки с кратким содержимым.
    • В геообъектах объект-promise метода 'open' хинта/балуна не возвращал значение, если вызывать открытие и закрытие до загрузки модулей.
    • Отображение хинта при наведении мыши не под курсором, а в центре у некоторых объектов.
    • Исчезала прокрутка в панели при изменении высоты балуна.
    • Ошибка при появлении дырок/разряжений в коллекции геообъектов.
    • Неверный курсор метки с опцией 'interactive: false'.
    • Не работало задание 'dataURI' / 'Image' / 'Canvas' в опцию 'fillImageHref' геообъектов.
    • Неправильная заливка во время зума для полигонов с самопересечениями.
    • Закрытие балуна кластера по событию 'change' состояния или изменению поля 'activeObject' приводило к ошибке.
    • При включении редактирования геометрий события 'editorstatechange' и 'statechange' кидались по два раза.
    • Вершина редактора графики спрыгивает в первоначальное место, если во время ее переноса сдвинуть карту.
    • Проблемы при повороте полигона с внутренним контуром.
    • Скролл во время перемещения вершины редактора приводил к ошибке.
    • Проблемы с отображением копирайтов на маленьких картах.
    • Порядок сортировки элементов раскрывающегося списка.
    • Ошибка в IE 10-11, вызывавшая изменение размеров раскрывающегося списка.
    • Ошибки в верстке раскрывающегося списка.
    • Изменение опции 'maxWidth' визуально не изменяло кнопку.
    • Мигала панель поиска и пробок при переключении табов.
    • Отсутствие копирайтов на планшетах.
    • Ошибка скрытия панели с результатами поиска при задании опции 'visible: false'.
    • Проблемы с выпадающим списком "Поиска по карте" при переходе в полноэкранный режим.
    • Ошибки в верстке и отображении элемента управления "Поиск по карте".
    • При ошибке поиска вместо надписи "Сервер не смог обработать запрос" отображалась надпись "Идет запрос к серверу...".
    • Не работало автомасштабирование к выбранному результату поиска по карте.
    • Проблемы с удалением средней точки маршрута.
    • Ошибка при попытке изменить координаты перед добавлением точки на карту в маршрутизаторе.
    • Некоторые неточечные объекты не отображались на карте в менеджере объектов и 'LoadingObjectManager'.
    • В менеджере объектов не возвращался объект-promise из метода 'open' хинта.
    • 'map.geoObjects.getBounds' возвращал 'null' при добавленном менеджере объектов на карту.
    • Ошибки в менеджере объектов при изменении дробного масштаба карты.
    • Некорректный результат метода 'getBounds' после удаления объектов из менеджера.
    • Cтрока "id" заменялась на 'object.id' в методе 'setFilter' менеджера объектов.
    • Исправлен порядок событий мыши в макетах и оверлеях.
    • Плавная смена масштаба в тайлах.
    • Проблемы при перемещении карты Internet Explorer 10.
    • Ошибки рендеринга меток на больших масштабах в Chrome.
    • Проблемы с жестами в Windows Phone.
    • Проблемы с версткой и пробрасыванием событий различными компонентами в старых версиях IE.
  • JSAPI 2.1.23 (17 марта 2015 г.) Скачать справочник
    Список изменений

    Добавлено:

    • В ObjectManager добавлена поддержка неточечных геообъектов.
    • В RemoteObjectManager и LoadingObjectManager появилась возможность определить имя callback-функции для JSONP-запроса.
    • В RemoteObjectManager появились методы setFilter(), getFilter() и getObjectState().
    • Опция noPlacemark в элементе управления "Геолокация".
    • Отображение ближайшей станции метро для топонимов в результатах поиска по организациям.

    Исправлено:

    • Невозможность перемещать геообъекты в режиме рисования.
    • Проблемы с интерактивностью и исчезновением геообъектов при перемещении между пейнами.
    • Некорректная работа хинта кластеров.
    • Ошибка при двойном клике по кластеру.
    • Некорректная работа опции icons в кластеризаторе.
    • Исчезновение иконки кластера при наведении курсора в некоторых случаях.
    • Значение 'boundsPath' для опции coordRendering у прямоугольника.
    • Ошибка с перемещением открытого балуна в ObjectManager.
    • Ускорено удаление геообъектов в ObjectManager.
    • Ошибки с работой балунов в ObjectManager.
    • Исправлена фильтрация кластеризованных объектов в ObjectManager.
    • Работа метода ObjectManager.getBounds() при кластеризации.
    • При использовании порядка координат 'longlat' балун ObjectManager открывался не в том месте.
    • Задание опции mapStateAutoApply для режима мультимаршрутизации при использовании ymaps.route.
    • Метод showResult() элемента управления "Поиск по карте" не выполнялся при включенных опциях noPlacemark и noCentering.
    • Отображение больших балунов организаций в режиме панели.
    • Ошибка с повторным запросом данных после неверного результата в поиске по организациям.
    • Ошибка в поиске по организациям, в результате которой иногда координаты могли возвратиться в неправильной последовательности.
    • Проблемы с одновременными действиями на карте, например, Balloon.autoPan() и Map.panTo().
    • Некорректная работа слоя активных областей после его обновления.
    • Ошибки при изменении опции hasBalloon у активных областей.
    • Ряд ошибок и неточностей в верстке элементов карты.
  • JSAPI 2.1.22 (26 февраля 2015 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Не показывались SVG-метки в Firefox при задании тэга <base>.
    • Не открывался балун загруженных через geoxml меток при указанном balloonTemplate.
    • Неправильно работал метод getResult в SearchControl при заданных опциях noPlacemark и noCentering.
  • JSAPI 2.1.20 (5 февраля 2015 г.) Скачать справочник
    Список изменений

    Исправлено:

    • Мигание подгружающихся тайлов при перетаскивании карты.
    • Исчезновение объектов при перетаскивании через 180-ый меридиан.
    • Проблемы с прозрачностью в площадных геообъектах.
    • Отображение нулевой обводки геообъектов.
    • При смене опции 'offset' у оверлеев не менялся результат вызова метода getShape().
    • Проблемы с 'autoPan' в балунах.
    • После автоматического позиционирования балуна открывался балун объекта, оказавшегося под курсором.
    • Ошибка отображения хинта геообъекта после закрытия балуна-панели.
    • Неправильная работа событий 'mouseleave' в активных областях при перетаскивании карты.
    • Поиск по организациям: исчезновение карточки организации сразу после открытия.
    • Артефакты при удалении с карты элемента управления "Поиск по карте".
    • Проблемы с отображением результатов элемента управления "Поиск по карте" на Народной карте.
    • Ошибка при редактировании транзитных точек в маршрутизаторе.
    • Проблемы с версткой точек и сегментов маршрутов в IE9 и Android Browser.
    • Ошибка в редакторе с возобновлением рисования после удаления существующих точек.
    • В редакторе не отображались направляющие линии в режиме рисования полигона/полилинии.
    • Удалялись конечные точки линейки при попытке поставить точку двойным кликом.
    • Исправлен ключ макета 'islands#multiRouterBigSmallPoint' на 'islands#multiRouterSmallWayPoint'.
    • Отсутствие события 'mousemove' в IE на touch-устройствах.
  • JSAPI 2.1.17 (30 октября 2014 г.) Скачать справочник
    Список изменений
    Добавлено:
    • Возможность добавлять пользовательские фильтры в шаблонах макетов.
    • Класс Template для работы с шаблонами HTML.

    Изменено:

    • RemoteObjectManager отображает объекты только в видимой области карты.

    Исправлено:

    • RemoteObjectManager не перерисовывал одинаковые объекты при смене коэффициента масштабирования.
    • Ошибка, из-за которой поле viaPointsChange события multiRouter.MultiRouteModel.requestsuccess могло принимать неверное значение.
    • Позиционирование меток при изменении масштаба страницы в Chromium-браузерах.
    • После выбора слоя в выпадающем списке слоев список не сворачивался.
    • В некоторых случаях возникали ошибки при вводе текста в элемент управления «Поиск по карте» при использовании мыши и клавиатуры одновременно.
    • Ошибки в работе редактора геообъектов.
    • Некорректная работа editor.startDrawing в обработчике события geometrychange у полигона.
    • Ошибки в отображении элемента управления «Пробки» при показе карты из скрытого контейнера.
    • В некоторых случаях в панели «Пробки» показывалось некорректное время.
    • В некоторых случаях возникали ошибки, если открыть балун на метке и затем изменить масштаб так, чтобы метка попала в кластер.
    • При драге маршрута не учитывался параметр searchCoordOrder.
    • В некоторых версиях IE не срабатывала анимация при смене тайлов.
    • Ошибки при изменении границ элементов во вложенных коллекциях.
    • Ошибки при удалении и повторном добавлении ObjectManager на карту.
    • Устранены утечки памяти.
    • Ошибки при попадании хотспотных объектов с одинаковым id в несколько соседних тайлов.
  • JSAPI 2.1.16 (17 сентября 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Опция activeRouteAutoSelection мультимаршрутизатора.
    • Событие update мультимаршрутизатора.
    • Поисковые подсказки в платной версии API.

    Исправлено:

    • Некорректная работа балуна кластера при задании html в clusterCaption.
    • Ошибки при работе с балуном точки редактора геообъекта в IE8.
    • Ошибки при фильтрации объектов в ObjectManager.
    • Метод ObjectManager.getObjectState возвращал некорректные значения для объектов вне области видимости.
    • В IE9, IE10 в некоторых случаях некорректно обрабатывалась смена zIndex маршрута.
    • Метод autoPan возвращал некорректное значение для балуна в режиме панели.
    • В некоторых случаях возникала ошибка при изменении значения опции yandexMapAutoSwitch.
    • Узловые точки редактора геообъектов съезжали относительно объекта в iOS7.
    • В некоторых случаях не срабатывала опция fillOpacity геообъекта.
    • В некоторых случаях не срабатывало изменение опции fill геообъекта.
    • Отсутствовал текст сообщения об ошибки в поисковом контроле в англоязычной версии.
    • Проблемы со скроллом дефолтного балуна кластера при задании произвольного макета itemContentLayout.
    • LoadingObjectManager и RemoteObjectManager отправляли некорректные запросы при переходе карты через нулевой меридиан.
    • В некоторых случаях не срабатывали опции единичных объектов в ObjectManager.
    • Ошибки при изменении опции hasHint кластеризатора.
    • В некоторых случаях хинт кластера не закрывался при уходе курсора с метки.
    • Ошибки в работе менеджера хинта ObjectManager.
    • В некоторых случаях некорректно отображалась метка кластера при переходе балуна в режим панели.
    • В некоторых случаях не закрывался балун метки при попадании метки в кластер в ObjectManager.
    • При повторном вызове метода GeoQueryResult.addToMap объекты удалялись и добавлялись на карту заново.
  • JSAPI 2.1.15 (28 августа 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • LoadingObjectManager — модуль, который позволяет добавлять на карту очень большое (действительно очень больше) число меток. При необходимости кластеризует их. Загружает с сервера данные только для тех меток, которые попадают в видимую область карты.
    • RemoteObjectManager — модуль, предназначенный для показа большого числа меток с использованием загрузки данных с сервера по тайлам или по области видимости карты. Использует серверную кластеризацию данных.

    Исправлено:

    • Дублирование текста при вводе с включенными поисковыми подсказками в Android-браузерах.
  • JSAPI 2.1.14 (7 августа 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Новые возможности шаблонизатора - elseif и квадратные скобки.
    • Возможность отменять предыдущие запросы при задании новых опорных точек и параметров в мультимаршрутизаторе.
    • Панель поисковых подсказок.
    • Параметр onerror при подключении API.
    • Возможность отключить выход из полноэкранного режима по нажатию клавиши Esc.
    • Добавлен метод GeoQueryResult.getParent.
    • Метод then объекта GeoQueryResult теперь поддерживает контекст исполнения функций обратного вызова.
    • Ускорена отрисовка графики с фоновым изображением.
    • Возможность указывать фигуру метки кластера в json-формате.
    Исправлено:
    • Ошибки графики в IE.
    • Ошибки мультимаршрутзатора.
    • Ошибка подключения двух разных версий API на одной странице.
    • В некоторых случаях возникала ошибка при клике по слою пробок в IE8.
    • В некоторых случаях возникала ошибка при удалении элемента управления «Пробки» с карты.
    • Ошибки отображения полигона с внутренним контуром.
    • Ошибки отображения графики с выставленной опцией opacity равной 0 в IE9-11.
    • Ошибочное отображение scrollbar в результатах поиска.
    • В некоторых случаях карта становилась неактивной в мобильной версии Chrome под Android.
    • Проблемы с драгом на WindowsPhone.
    • Ошибка с прокидыванием событий из-под макета ItemContent в балуне кластера.
    • Ошибки верстки элементов управления в IE8.
    • Ошибка повторного добавления элемента в ObjectManager.
    • Ошибка отображения балуна при инициализации из скрытого контейнера.
    • Ошибка вызова метода autoPan в менеджерах балуна.
    • Ошибка драга объектов под слоем событий.
    • Балун в режиме панели не сдвигал элемент управления «Линейка».
    • Ошибки перехода в полноэкранный режим при нахождении карты в контейнере с динамической шириной.
    • Ошибка скрытия подсказки в некоторых случаях.
  • JSAPI 2.1.11 (26 июня 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Общественный транспорт в мультимаршрутизаторе.
    • Модуль ObjectManager для отображения большого количества меток на карте.
    Изменено:
    • Обновлен модуль Регионы.
    • map.geoObjects.getBounds теперь учитывает объекты в составе кластеризатора.

    Исправлено:

    • Ошибки при инициализации карты в iframe.
    • Перепутанный порядок событий click, select и press для FullscreenControl.
    • Элемент управления zoomControl не учитывал отступ снизу при расчете своих размеров.
    • Контейнер с подложкой смещался относительно контейнера событий в Android 4.x.
    • В некоторых случаях браузер неожиданно завершал работу на устройствах iOS с Retina-экранами.
    • Неправильное отображение карты в элементе с position: fixed в webkit.
    • Не срабатывала опция strictBounds в control.SearchControl.
    • Ошибки анимации control.ListBox в iOS 6.
    • Срабатывание enter на элементе управления «Поиск на карте» осуществляла submit родительской формы.
    • Некорректное отображение время в панели пробок при смене часового пояса.
    • Ошибка при использовании API с библиотекой sugar.js в IE8.
  • JSAPI 2.1.9 (24 апреля 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Опция shape в templateLayoutFactory.
    • Документирована модульная система API 2.1.
    • Возможность указывать пустой неймспейс (параметр загрузки ns) с получением функциональности API в качестве аргумента вызова функции onload.
    • Документированы стандартные реализации интерфейса IPane.

    Изменено:

    • Метка кластера при наведении курсором мыши увеличивает z-index.
    • Promise, возвращаемый функцией ymaps.ready, подтверждается неймспейсом ymaps.

    Исправлено:

    • Работа методов removeMapType и removeAllMapTypes в элементе управления «Слои».
    • Ошибка выставления состояния скролла в балуне кластера по умолчанию.
    • Артефакты в верстке балуна-аккордеона кластера в AndroidBrowser.
    • Ошибка при разборе запроса geoQuery.search.
    • «Дрожание» меток в iOS 6.
    • Проблемы с активацией элементов управления «Слои» и «Пробки» на планшетах под управлением OS Android.
    • Мерцание элемента управления «Пробки» в тач-интерфейсе.
    • Ошибки верстки элемента управления «Пробки».
    • Ошибки верстки в IE.
    • Ошибка при выключении редактора графики.
    • В некоторых ситуациях не изменялась высота балуна-панели при изменении высоты карты.
    • Методы getElement и getBalloonElement возвращали некорректные значения в режиме панели.
    • В некоторых ситуациях в балуне кластера отсутствовал горизонтальной скролл.
    • Балун-панель мог перекрывать метку на которой был открыт.
    • В некоторых ситуациях не скрывался хинт пробок в браузере FireFox.
    • Проблемы с производительностью на iPad при включенном слое пробок.
    • В некоторых ситуациях сбрасывался пресет маркера после закрытия балуна.
  • JSAPI 2.1.7 (10 апреля 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Маршрутизатор с альтернативными маршрутами.
    • Опция zoomMargin в SearchControl.
    • Метод setAll в менеджере данных data.Manager.

    Изменено:

    • Обновление дизайна балунов кластеров.
    • Стандартные метки кластера переведены на SVG.
    • Изменен дизайн балунов дорожных событий.
    • При задании опции position элементов управления значение опции float трактуется как none.

    Исправлено:

    • Небольшие интерфейсные ошибки.
    • Мигание элементов управления при отображении карт на мобильных устройствах.
    • Инициализация SearchControl из скрытого контейнера.
    • Применение опции drawingCursor.
    • В некоторых случаях не скрывалась подсказка геообъекта.
    • В некоторых случаях pixelgeometrychange происходило в неправильное время.
    • Небольшие ошибки в новом шаблонизаторе.
    • Не выбирался первый найденный элемент в элементе управления «Поиск на карте».
    • Некорректно отрисовывалась белая подложка линии линейки на больших расстояниях.
    • Режим редактирования полигонов и полилиний не отключался по двойному клику.
    • Маршрут продолжал редактироваться после деактивации соответствующего элемента управления.
    • Не вовремя генерировалось событие vertexdragend.
    • Не происходил клик в выпадающих списках в бразуерах операционной системы Android.
    • Ошибки при анимации элемента управления «Пробки».
    • Ошибки в верстке масштабного отрезка.
    • В менеджере элементов управления нельзя было подписаться на события дочерних элементов.
    • Неправильный индекс добавленной вершины в событии vertexadd редактора полигона.
    • При изменении позиции zoomcontrol принимал неверный размер.
    • Ошибки в верстке элемента управления «Поиск по карте» в Internet Explorer версий 8 и 9.
    • При вызове метода search у элемента управления «Поиск на карте» в состояниях small и medium по умолчанию не показывался выпадающий список с результатами поиска.
    • Линия на карте моргала, если при наведении увеличивать strokeWidth.
    • Откорректировано поведение .behavior.MultiTouch.
    • После удаления всех точек из полигона отключался режим рисования.
    • Открывался пустой балун по клику по линии маршрута.
    • Неправильное значение поля position в DOM-событиях в Internet Explorer.
    • Точки маршрута не ставились поверх геообъектов.
    • В некоторых случаях некорректно рассчитывались размеры содержимого балуна.
    • Опции отображения геообъекта неверно обрабатывались на устройствах с высокой плотностью пикселей.
    • Не изменялась активная область метки при изменении стиля метки.
    • Не помещалась информация об объекте в балуне-панели.
    • В некоторых случаях нажатие на объект на карте вызывало смещение карты.
    • Происходила ошибка, если открыть балун кластера в момент, когда на карте уже открыт другой балун.
    • Не работала опция tremor в behavior.Drag.
    • В Internet Explorer пропадала метка после закрытия балуна.
    • При переключении balloonPanelMaxMapArea некоторые опции не срабатывают корректно.
    • Не срабатывала геолокация пользователя по IP.
    • Тянущиеся метки не растягивались, если в содержимом метки был пробел.
    • Не появлялось контекстное меню по правому клику в балунах.
    • Ошибки при добавлении типов карт в TypeSelector.
    • Падение приложения на iPad с Retina-экраном.
    • Ошибка уничтожения карты сразу после создания.
    • Ошибки в модуле geoXML.
    • Смещение панели балуна и копирайтов при выделении текста.
  • JSAPI 2.1.5 (11 февраля 2014 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Методы ymaps.ready и ymaps.load возвращают объект класса vow.Promise.
    • Позиция выпадающего списка зависит от положения кнопки вызова списка на карте.
    • Поддержка вложенных неймспейсов для параметра «ns» загрузчика API.
    • Методы класса util.AsyncStorage возвращают объект класса vow.Promise.
    • Обновлена реализация vow.Promise для соответствия со стандартом http://dom.spec.whatwg.org/#promises.
    • Текстовые шаблоны переведены на новый синтаксис. Добавлена поддержка цикла for, обработка вложенных условий и циклов. Подробное описание читайте в документации.

    Изменено:

    • Ускорено построение макета балуна кластера.

    Исправлено:

    • Скроллинг длинных списков в Safari iOS7.
    • Ошибки верстки панели управления «Пробки» в Opera.
    • Конфликты верстки при подключении библиотеки bootstrap.
    • Конфликты показа результатов поиска и клавиатуры на мобильных устройствах для элемента управления «Поиск по карте».
    • Ошибки верстки выпадающего списка в Opera.
    • Поведение балунов и подсказок меток в IE8.
    • Ошибки при динамическом изменении опций hasHint и hasBalloon кластеризатора.
    • Лишнее срабатывание анимации в элементе управления «Поиск по карте».
    • Ошибки при удалении элемента управления «Поиск по карте».
    • Отсутствует кнопка удаления поискового запроса в IE8.
    • Ошибки верстки панели управления «Пробки».
    • Убрали эмулирование события contextmenu в браузерах на WinPhone, которые его не поддерживают.
    • В некоторых случаях зависал мобильных браузер при смене масштаба карты при включенных пробках.
    • Зацикливание кода при вложенной подписке на обработчик ymaps.ready.
    • Конфликты при подключении двух версий на одной странице.
    • Метод getZoomRange не попадал в package.full.
    • Утечки памяти при обработке событий.
    • Дублировалось событие balloonopen и balloonclose кластеризатора.
    • Ошибки в режиме release при удалении кластеризатора с карты.
    • Сбрасывались пресеты меток при повторном закрытии балуна.
    • Дублирование событий mouseenter в IE8 и IE9.
    • Не приходило событие click на кластере, если на нем при этом открывался балун.
    • Отправка поискового запроса по клавише Enter в IE8.
    • Не работало масштабирование карты двойным щелчком кнопки мыши при клике на геообъекты без балуна.
    • Кластеризатор не генерировал события optionschange.
    • Не работала опция pane для точечных геообъектов.
    • При редактировании линии и полигона балун смещался.
    • Лишние событие close и balloonclose геообъекта и его балуна.
    • Лишние события autopanbegin и autopanend балуна геообъекта.
    • У программно созданных макетов не вызывался метод destroy.
    • В некоторых случаях дублировались события defaultaction в контролах.
    • После закрытия балуна геообъекта появлялась подсказка.
    • Не ставились точки линейки поверх геообъектов.
    • Некорректно позиционировались мини-балуны линейки в IE8 и IE9.
    • Ошибки панели управления «Пробки» при ее повторном добавлении на карту.
    • Ошибки в верстке выпадающих списков в IE8.
    • Изменялся центр карты по длинному нажатию по геообъекту в Safari iOS 6.1.
    • В некоторых случаях не пропадали подсказки кластеров.
    • В Windows 8 приходили одновременно события click и contextmenu.
    • При автоматическом проваливании в народную карту в Firefox не показывались тайлы для устройств с высокой плотностью пикселей.
    • В некоторых случаях пропадала интерактивность геообъектов при изменении масштаба карты.
    • При изменении опции pane выставлялось некорректное значение zIndex геообъектов.
  • JSAPI 2.1.4 (19 декабря 2013 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Возможность отображения всплывающей подсказки в кластеризаторе.
    • В geometry.LineString добавлен метод getDistance.
    • Поле currentTarget при распространении событий геообъектов.
    • Пресеты для кластеризатора можно напрямую задавать в метке кластера.
    • Значение опции clusterIconContentLayout можно выставлять в null для отображения метки кластера без содержимого.
    • Возможность задавать shape в описании меток кластеров.
    • Параметр context в методе GeoQueryResult.each.
    • Опция балуна panelMaxMapSize.
    • Опция interactiveZIndex, которая отключает автозадание zIndex в зависимости от состояния геообъекта.
    • Добавлен пейн overlays.
    • Опция iconOpacity для меток.
    • Кнопка «показать еще результаты» для элемента управления «Поиск по карте».
    • Опция viewportMargin кластеризатора.

    Изменено:

    • Методы кластеризатора get, each, getIterator заменены на getGeoObjects и getClusters.
    • Объект Cluster переименован в ClusterPlacemark.
    • Улучшена логика проваливания в Народную карту.
    • Метод работы с балуном кластера placemark.balloon.open и cluster.balloon.open.
    • Теперь метки в кластеризатор всегда добавляются синхронно.

    Исправлено:

    • Поддержка Windows Phone 8.
    • Ошибки с видимостью текста в поисковой строке.
    • Ошибки с отображением копирайтов.
    • Ошибки при позиционировании элементов списка при отрицательных индексах.
    • Некорректное поведение кластеризатора при значении опции gridSize, не равном степени двойки.
    • На карте генерировались лишние события mouseleave в IE8 и IE9.
    • Ошибки при попытке сброса значения опции менеджера элементов управления.
    • Ошибки в удалении набора элементов управления с карты.
    • Ошибки после включения режима рисования метки.
    • Ошибки загрузки API без указания параметра load.
    • Утечки памяти при удалении событий налету в domEvent.manager.
    • Ошибки при клике правой кнопкой мыши в браузер с pointer-событиями.
    • При открытии панели балуна копирайты не смещались вверх.
    • Ошибки в верстке панели управления «Пробки» в Opera.
    • Ошибки в верстке выпадающего списка.
    • Неправильный учет zIndex оверлеев, которые находятся в разных пейнах.
    • Инвертированный scroll zoom в Chrome.
    • Ошибки в распространении событий на геообъектах, не имеющих балуна.
    • Неправильное перерисование балуна при изменении размеров карты или при перетаскивании метки.
    • Проблемы с производительностью при использовании проекции Cartesian.
    • В IE8 не появлялся балун при выходе из полноэкранного режима.
    • При удалении линейки оставались открытые подсказки, если крайнюю точку линейки удаляли двойным кликом.
    • Ломалась линейка после добавления новой точки из середины отрезка.
    • Балун превращался в панель, если карта невысокая, но широкая.
    • При открытии на метке балуна с autoPan на карте оставался курсор.
    • Hintclose отображался по движению карты, даже если подсказки нет.
    • Не менялся текст в элементе управления «Пробки» при перемещении в регион без данных.
    • Ошибки в интерактивности меток при экспорте через YMapsML.
    • Иконка не удалялась из кнопки после использования метода unset.
    • Некорректно позиционировались подсказки над узлами линейки.
    • Не скрывалась метка кластера при открытии балуна.
    • Разные размеры точки линейки в IE и Opera.
    • Съезжал балун у линии при зуме.
    • Лишние mouseenter на объектах карты.
    • При зуме колесом мыши вместе с картой скроллилась страница в Firefox.
    • В режиме редактирования при продолжении линии пропадала часть, отображающая «продолжение» при наведении.
    • В некоторых случаях не изменялось значение поля GeoObject.state.get (‘hover’) при первом движении курсора.
    • Правильный порядок событий click, select и press для FullscreenControl.
    • Часть элементов управления не сворачивалась при mousedown на карте.
    • В некоторых случаях балун не перемещалася вслед за геообъектом.
    • Ошибки опции drawOver в geometryEditor.
    • Ошибки при быстром завершении редактирования объектов.
    • Ошибки при включении опции geodesic.
    • Подсказка геообъекта появлялась при открытии балуна объекта активной области.
    • Некорректная работа API при подключении библиотеки bootstrap.
    • При изменении видимой области карты приходили события неправильного типа.
    • Ошибки при бросании balloonclose и balloonopen у активных областей.
    • Ошибки при autoPan при работе с линейкой.
    • Не работала опция interactivityModel у всплывающих подсказок.
    • При смене типа карты кнопки в зуме не переставали быть активными/неактивными.
    • Не появлялся курсор в поисковой строке по нажатию на SearchControl.
    • Ломалось перемещение геообъектов после перемещения касанием.
    • В некоторых случаях перестраивался элемент управления выбора типа карты при смене опций.
    • Лишнее сворачивание и разворачивание элементов управления при переходе в полноэкранный режим.
    • Ошибки при удалении типов карты из control.TypeSelector.
    • Ошибки рендеринга геометрий.
    • Изменение размера карты по вертикали в полноэкранном режиме в IE8.
    • Ошибки работы API в IE8.
  • JSAPI 2.1.3 (14 ноября 2013 г.) Скачать справочник
    Список изменений

    Добавлено:

    • Поддержка IE11.
    • Поддержка iOS7.
    • Новые режимы работы метода panTo.
    • Кнопки изменения масштаба карты теперь становятся неактивными при достижении крайних масштабов.
    • Объект STOP_ITERATION в интерфейсе IIterator.

    Исправлено:

    • Ошибки в IE.
    • Не работало изменение zIndex-ов геообъектов в обработчике событий наведения мыши, открытия балуна, перемещения карты.
    • Ошибки в верстке элемента управления «Пробки».
    • Некорректная работа при вызове метода Balloon.autoPan во время плавного движения карты.
    • Не удалялась иконка из кнопки при использовании метода options.unset.
    • Невозможно было сделать кнопку линейки недоступной.
    • Слой активных областей кидал событие defaultaction два раза.
    • Переменная YMaps утекала в глобальную область видимости.
    • В некоторых ситуациях удаление кнопки с карты приводило к исключению. Ошибки при перетаскивании точек линейки.
    • Пустая подсказка над первой точкой линейки.
    • Не приходили события с содержимого SVG-меток.
    • Ошибка в верстке тянущихся иконок.
    • Некорректное перетаскивание меток в webkit-браузерах под Windows 8.
    • Не приходило событие contextmenu при двойном клике правой кнопки. Конфликт поведения ruler и routeEditor.
    • Не генерировались mouseenter и mouseleave на карте.
    • Не генерировалось событие press для FullscreenControl и GeolocationControl. Перед contextmenu не генерировалось событие mousedown.
    • Неправильная активная область у тянущейся метки.
    • На тач-устройствах не пропадала подсказка геообъекта после перетаскивания.
    • Не отображалась подсказка при открытом балуне.
    • Событие userclose в балуне срабатывало дважды.
    • В некоторых ситуациях не срабатывал элемент управления Fullscreen. Неправильный расчет размеров элементов в Firefox.

Форма обратной связи

Если при переключении версии API ваше приложение стало работать некорректно или вы обнаружили какие-либо ошибки в функциональности, пожалуйста, напишите нам об этом. Постарайтесь максимально подробно описать проблему и по возможности приложите скриншот.