Создание карты

Создавайте карту после того, как веб-страница загрузится целиком. Это даст уверенность в том, что контейнер для карты создан и к нему можно обращаться по id.

Чтобы добавить карту на страницу, создайте обработчик события окончания загрузки страницы onLoad и разместите его в теге head после скрипта загрузки API:

<script type="text/javascript">
    // Создает обработчик события window.onLoad
    YMaps.jQuery(function () {
        // Создает экземпляр карты и привязывает его к созданному контейнеру
        var map = new YMaps.Map(YMaps.jQuery("#YMapsID")[0]);

        // Устанавливает начальные параметры отображения карты: центр карты и коэффициент масштабирования
        map.setCenter(new YMaps.GeoPoint(37.64, 55.76), 10);
    })
</script>
Совет. Для создания обработчика события onLoad и ссылки на DOM-элемент, служащий контейнером карты, удобно использовать встроенный в API фреймворк jQuery.

В обработчике события onLoad:

  1. Создайте с помощью оператора new новый экземпляр базового класса YMaps.Map:
    var map = new YMaps.Map(YMaps.jQuery("#YMapsID")[0]);
    Примечание. На веб-странице каждый экземпляр этого класса представляет одну карту.
  2. Задайте с помощью метода setCenter() начальные параметры отображения карты: географические координаты центра карты (центр Москвы: 37.63, 55.75) и коэффициент масштабирования (10):
    map.setCenter(new YMaps.GeoPoint(37.64, 55.76), 10);

    Подробнее о параметрах карты читайте в разделе Параметры карты.

    Совет. Для того чтобы не определять координаты центра карты вручную, воспользуйтесь инструментом "Определение координат".

При создании карты можно указать два необязательных параметра:

  • ignoreResize - включает игнорирование обработки событий, связанных с изменением размера карты;
  • coordSystem - указывает тип координатной системы, использующейся на карте (по умолчанию принята стандартная географическая система координат). Подробнее о применении встроенных координатных систем, а также о том, как создать пользовательскую систему, читайте в разделе Создание пользовательской координатной системы.