[YandexMaps2] 1.2.0 События jQuery и API ключ

У компонента появился jQuery триггер ymOnLoadMap. Теперь можно после загрузки карты выполнить свой JS код, не прибегая к правкам исходного default.js.

Также, не так давно Яндекс внедрил для карт обязательное указание API ключа. В связи с этим, пользователям компонента YandexMaps2 нужно произвести некоторые действия, чтобы их карты работали и дальше.

Быстрый старт

Шаг 1

Первым делом нужно сгенерировать API ключ. Заходите в Кабинета Разработчика, там жмёте «Получить ключ» и при заполнении полей выбираете сервис «JavaScript API и HTTP Геокодер».

Шаг 2

После отправки запроса, новый ключ из раздела «Ключи» копируете и вставляете в системную настройку ym2_api_key.

Для тех, кто обновляется

Выполните действия из раздела «Быстрый старт» и поправьте настройку ym2_api_url, указав там что-то вроде:

//api-maps.yandex.ru/2.1/?lang=ru_RU&load=package.full&apikey={$key}

Я не могу автоматически править эту настройку, т.к. если вы ранее меняли значение в ней, то может возникнуть конфликт и карты на вашем сервисе перестанут работать.

ymOnLoadMap

Данное событие сработает при загрузке карты. Пользоваться триггером достаточно просто. Вот пример кода:

$(document).ready(function() {
    $(document).on('ymOnLoadMap', function(e, ym2, map) {
        console.log('ym2', ym2); // Экземпляр класса YandexMaps2
        console.log('map', map); // Объект карты
    });
});

Более подробно можно почитать в документации компонента. К примеру, можно отключить все элементы управления на карте.