Создание карты
Создавайте карту после того, как веб-страница загрузится целиком. Это даст уверенность в том, что контейнер для карты создан и к нему можно обращаться по 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
:
-
Создайте с помощью оператора
new
новый экземпляр базового класса YMaps.Map:var map = new YMaps.Map(YMaps.jQuery("#YMapsID")[0]);
Примечание
На веб-странице каждый экземпляр этого класса представляет одну карту.
-
Задайте с помощью метода
setCenter()
начальные параметры отображения карты: географические координаты центра карты (центр Москвы: 37.63, 55.75) и коэффициент масштабирования (10):map.setCenter(new YMaps.GeoPoint(37.64, 55.76), 10);
Подробнее о параметрах карты читайте в разделе Параметры карты.
Примечание
Для того чтобы не определять координаты центра карты вручную, воспользуйтесь инструментом "Определение координат".
При создании карты можно указать два необязательных параметра:
ignoreResize
- включает игнорирование обработки событий, связанных с изменением размера карты;coordSystem
- указывает тип координатной системы, использующейся на карте (по умолчанию принята стандартная географическая система координат). Подробнее о применении встроенных координатных систем, а также о том, как создать пользовательскую систему, читайте в разделе Создание пользовательской координатной системы.
Удаление карты
Чтобы удалить карту вызовите метод destructor() объекта карты. Например, карту можно удалить по событию onunload
:
<body onunload="map.destructor();">