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

Перехід з версії 1.0.0.

Завантаження карти
  • Код ініциалізації карти необхідно виконувати у функції createVisicomMap().Ви повинні самі визначати цю функцію (див. приклад).
  • Клас VMapEngine замінено на VMap.
Координати
  • Класы VPoint і VGeoPoint забрані з ядра.Система працює тільки з географічними координатами.
  • Координати для всіх об'єктів передаються структурою {lng: 30.5112, lat: 50.4550}; (див. приклади).
Якщо в вашій базі даних є збережені локальні координати, то їх необхідно привести до географічних. Зробити це можливо 2-ма способами:
  • З допомогою XMLAPI 1.0.1
    використовуючи метод loc2geo (див. документація)
  • З допомогою Maps API 1.0.0
    використовуючи функцію VPoint.convertToGeoPoint() (див. документація)
Рівні масштабу
  • Так як замінена проекція візуалізації карти, то рівні масштабу трохи змінились. Но для бази 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(). Він також перевіряє розмір вікна карти.