Визиком карты

Переход с версии 1.0.0.

Загрузка карты
  • Код инициализации карты необходимо производить в функции createVisicomMap().Вы должны сами определить эту функцию (см. пример).
  • Класс VMapEngine заменен на VMap.
Координаты
  • Классы VPoint и VGeoPoint убраны из движка.Система работает только с географическими координатами.
  • Координаты для всех объектов передаются структурой {lng: 30.5112, lat: 50.4550}; (см. примеры).
Если в вашей базе данных есть сохраненные локальные координаты, то их необходимо привести к географическим. Сделать это можно 2-мя способами:
Уровни масштаба
  • Так как заменена проекция отображения карты, то уровни масштаба немного изменились. Но для базы ukraine_ru (ua, en) остались те же 12 масштабов.
    Если Вы хотите использовать 18 мировых масштабов (на данный момент есть только Украина и Белорусия), то необходимо подлючить карту world_ru.
Добавление/удаление объектов
  • У классов VMap и VLayer убраны методы addMarker(), addPolyline() и т.д.
    Добавление и удаление любого объекта выполяняется функциями add(obj) и remove(obj).
Работа с событиями
  • Вместо объекта VEvents необходимо использовать соответствующие методы классов VMap, VMarker (см. пример).
Маркеры
  • Работа с маркером существенно не поменялась. Но есть некоторые особенности. Для открытия информационного окна необходимо выполнить такой код:

    // информационное окно должно быть уже установлено для маркера
    marker.info(),visible(true);
    map.repaint();

    Скрытие:
    marker.info(),visible(false);
    map.repaint();
  • Также информационные окна являются простыми объектами, их можно добавлять на карту без маркера.

    var info = new VInfoWindow({lng: ..., lat: ...}, "Текст");
    map.add(info);
    map.repaint();

    При таком добавлении информационное окно будет всегда отображаться на экране.
    Некоторое поведение можно запрограммировать с помощью опций (см. описание).
Графика
  • Классы VPolyline и VPolygone заменены на VLine и VArea соотвественно. Работа с этими классами существенно не поменялась.
    Параметры:

    <html xmlns:v="urn:schemas-microsoft-com:vml">

    и блок стилей

    v\:* { behavior: url(#default#VML) }
    добавляются автоматически.
Расчет маршрута и удаленные сервисы
  • Данные сервисы предоставляются только зарегистрированным пользователям (см. описание).
  • В новом API маршруты предоставляются как дополнение к движку.
    Для этого необходимо подключать JavaScript файл с нашего сервера (см. описание).
  • Для расчета маршрута необходимо применять метод класса VRemoteCall.request().
    Все запросы считаются как запросы к XMLAPI методу getRoute.
Другие измененные классы и методы
  • VBounds. Вместо него используйте VRect
  • VMapEngine.resizeViewport(). Используйте метод VMap.repaint(). Он также проверяет размер окна карты.