Подключение API

Описание

Работа с картой возможна только после того, как в браузер будет загружен код API карт. Есть несколько способов его загрузки.

Простой способ

Сперва подключим API карт, поместив в секцию head HTML-страницы следующий код:

<script src="http://maps.api.2gis.ru/2.0/loader.js?pkg=full"></script>

Затем воспользуемся функцией DG.then, в которую поместим код инициализации карты:

DG.then(function() {
    map = DG.map('map', {
        'center': [54.98, 82.89],
        'zoom': 13
    });
});

Внутри себя эта функция добавляет обработчик события загрузки страницы. Именно такой способ рассматривался в разделе «Быстрый старт».

Загрузка по требованию

Вы можете загрузить API карт именно в тот момент, когда карта станет нужна. Для этого в URL подключения API необходимо добавить параметр lazy=true:

<script src="http://maps.api.2gis.ru/2.0/loader.js?pkg=full&lazy=true"></script>

Затем в нужный момент времени (например, при нажатии на кнопку) необходимо вызвать функцию DG.then:

DG.then(function() {
    map = DG.map('map', {
        'center': [54.98, 82.89],
        'zoom': 13
    });
});

Опции подключения

Ниже описаны все опции, которые может принимать URL загрузки API карт:

Опция По умолчанию Описание
pkg full Пакет загружаемых модулей. На данный момент поддерживается 2 пакета: full — все модули API; basic — базовая функциональность (балуны, маркеры, геометрии).
skin dark Тема карты (светлая или темная). Принимает значение light или dark.
lazy false Если указать значение true, тогда API карт загрузится отложенно, при первом вызове DG.then.

Функция DG.then

Как было описано ранее, функция DG.then отвечает за отслеживание момента загрузки API карт и добавление обработчиков этого действия. Параметры функции:

Вызов Возвращает Описание
DG.then( <Function> resolve, <Function> reject ) Promise Регистрирует обработчики загрузки API. Пареметры: resolve — сработает при успешной загрузке API карт, reject — в случае ошибки сервера.

Вызов функции DG.then в любой момент после загрузки API мгновенно выполнит обработчик.