Руководство по переходу на JavaScript API 2.0
Документ содержит примеры кода для выполнения основных операций с JavaScript API Яндекс.Карт первой и второй версий.
Подключение API
Версия 1.1 | Версия 2.0 |
URL API: https://api-maps.yandex.ru/1.1/index.xml. Загруженный API включает в себя библиотеку jQuery. | URL API: https://api-maps.yandex.ru/2.0/. Обязательным является параметр lang. Доступные параметры:
API не включает в себя библиотеку jQuery и допускает пакетную загрузку (минимизация трафика). |
Версия 1.1 | Версия 2.0 |
URL API: https://api-maps.yandex.ru/1.1/index.xml. Загруженный API включает в себя библиотеку jQuery. | URL API: https://api-maps.yandex.ru/2.0/. Обязательным является параметр lang. Доступные параметры:
API не включает в себя библиотеку jQuery и допускает пакетную загрузку (минимизация трафика). |
Создание карты
Версия 1.1 | Версия 2.0 |
Центр, тип и коэффициент масштабирования карты задаются после ее инициализации. | Центр, тип и коэффициент масштабирования карты задаются при ее инициализации. |
Версия 1.1 | Версия 2.0 |
Центр, тип и коэффициент масштабирования карты задаются после ее инициализации. | Центр, тип и коэффициент масштабирования карты задаются при ее инициализации. |
Параметры карты
Изменение области просмотра карты
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Плавное перемещение центра карты
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Получение максимального и минимального масштабов карты
Версия 1.1 | Версия 2.0 |
Получение максимального и минимального значений коэффициентов масштабирования - синхронная операция (все необходимые данные загружаются при подключении API). Максимальное и минимальное значения коэффициентов масштабирования определяются для заданной области просмотра карты. | Получение максимального и минимального значений коэффициентов масштабирования - асинхронная операция (при вызове метода формируется запрос к серверу, после чего данные передаются в callback-функцию). Максимальное и минимальное значения коэффициентов масштабирования определяются для заданной точки карты. |
Версия 1.1 | Версия 2.0 |
Получение максимального и минимального значений коэффициентов масштабирования - синхронная операция (все необходимые данные загружаются при подключении API). Максимальное и минимальное значения коэффициентов масштабирования определяются для заданной области просмотра карты. | Получение максимального и минимального значений коэффициентов масштабирования - асинхронная операция (при вызове метода формируется запрос к серверу, после чего данные передаются в callback-функцию). Максимальное и минимальное значения коэффициентов масштабирования определяются для заданной точки карты. |
Поведения карты
Включение поведений карты
Версия 1.1 | Версия 2.0 |
Включать поведения карты можно только после ее инициализации. | Включать поведения карты можно как при ее создании, так и после. |
Версия 1.1 | Версия 2.0 |
Включать поведения карты можно только после ее инициализации. | Включать поведения карты можно как при ее создании, так и после. |
Отключение поведений карты
Версия 1.1 | Версия 2.0 |
Поведения карты отключаются после ее инициализации. | Отключать поведения карты можно как при ее инициализации, так и после. |
Версия 1.1 | Версия 2.0 |
Поведения карты отключаются после ее инициализации. | Отключать поведения карты можно как при ее инициализации, так и после. |
Добавление геообъектов на карту
Версия 1.1 | Версия 2.0 |
Все геообъекты добавляются на карту с помощью метода | Все геообъекты добавляются на карту через глобальную коллекцию |
Версия 1.1 | Версия 2.0 |
Все геообъекты добавляются на карту с помощью метода | Все геообъекты добавляются на карту через глобальную коллекцию |
Метка
Версия 1.1. | Версия 2.0 |
| |
Версия 1.1. | Версия 2.0 |
| |
Балун
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Всплывающая подсказка
Версия 1.1 | Версия 2.0 |
Позиция всплывающей подсказки задается локальными пиксельными координатами. | Позиция всплывающей подсказки может быть задана как в географических, так и пиксельных координатах (при указании пиксельных координат нужно передать специальную проекцию). |
Версия 1.1 | Версия 2.0 |
Позиция всплывающей подсказки задается локальными пиксельными координатами. | Позиция всплывающей подсказки может быть задана как в географических, так и пиксельных координатах (при указании пиксельных координат нужно передать специальную проекцию). |
Ломаная линия
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Многоугольник
Версия 1.1 | Версия 2.0 |
Если координаты первой и последней вершин многоугольника не совпадают, то при его отрисовке эти вершины будут автоматически соединены. | Если у многоугольника координаты первой и последней вершин не совпадают, то при создании этого многоугольника добавится еще одна вершина, совпадающая с первой. |
Версия 1.1 | Версия 2.0 |
Если координаты первой и последней вершин многоугольника не совпадают, то при его отрисовке эти вершины будут автоматически соединены. | Если у многоугольника координаты первой и последней вершин не совпадают, то при создании этого многоугольника добавится еще одна вершина, совпадающая с первой. |
Коллекции
Создание коллекции
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Отображение элементов коллекции на карте
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Удаление элементов из коллекции
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Задание стиля для элементов коллекции
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Элементы управления картой
Добавление элементов управления на карту
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Удаление элементов управления с карты
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
События
Добавление обработчика события карты
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Удаление обработчика события
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Геопоиск
Прямое геокодирование
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Обработка событий геокодера
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Маршрутизатор
Создание маршрута
Версия 1.1 | Версия 2.0 |
Точки маршрута можно задавать, указав либо их координаты (объект класса | Точки маршрута могут быть заданы в одном из следующих форматов:
|
Версия 1.1 | Версия 2.0 |
Точки маршрута можно задавать, указав либо их координаты (объект класса | Точки маршрута могут быть заданы в одном из следующих форматов:
|
Добавление маршрута на карту
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |
Обработка событий маршрутизатора
Версия 1.1 | Версия 2.0 |
| |
Версия 1.1 | Версия 2.0 |
| |