ВебмастерМетрикаВиджетыРекламная сетьДиректПоиск для сайтаAPI
ещё
Найти
Например, ymaps:GeoObjectCollection

API Карт:

Войти

JavaScript API 1.x
В формате PDF
← Ctrl предыдущаяследующая Ctrl →

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

Создавайте карту после того, как веб-страница загрузится целиком. Это даст уверенность в том, что контейнер для карты создан и к нему можно обращаться по 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 - указывает тип координатной системы, использующейся на карте (по умолчанию принята стандартная географическая система координат). Подробнее о применении встроенных координатных систем, а также о том, как создать пользовательскую систему, читайте в разделе Создание пользовательской координатной системы.

Удаление карты

Чтобы удалить карту вызовите метод destructor() объекта карты. Например, карту можно удалить по событию onunload:

<body onunload="map.destructor();">

Открыть пример в новом окне