Візіком – карта Києва, Харкова, Львова, Криму, Донецька, Одеси, Мінську, Гомеля та інших міст України та Білорусії

Visicom XML API 1.0.2

Основи

Компанія "Візіком" надає зручний механізм для інтеграції online карти в web-сторінку. Дане керівництво описує всі можливості Visicom Maps API. З допомогою цього механізму ви зможете розмістити на карті Ваші точкові об'єкти, відмітити площинний об'єкт, прокласти найкоротший маршрут.

На даній сторінці показано приклад найпростішої інтеграції карти у веб-сторінку.

Приклад інтеграції карти:

Карта Киева

Вихідний код:

Для встановлення карти на своєму сайті, достатньо створити HTML файл з наступним змістом.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
 <head>
  <title>Карта України - Visicom Maps API 2.0.0</title>
  <meta http-equiv="imagetoolbar" content="no" />
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
 </head>
 

 <body>
  <script type="text/javascript" src="http://maps.visicom.ua/api/2.0.0/map/world_ru.js"></script>
  <div id="viewport" style="width: 740px; height: 580px;">
   <a id="visicom_copyright_link" href="http://maps.visicom.ua/">карта Киева</a>
  </div>
 

 <script type="text/javascript">
 
  var map;
  function createVisicomMap() {
   map = new VMap(document.getElementById('viewport'));
   var point = {lng: 30.51127413, lat: 50.45504171};
   map.center(point, 5);
  }
 
 </script>
 
 </body>
</html>

Ініціалізацію карти необхідно виконати в функції createVisicomMap().
Строка var map = new VMap(document.getElementById('viewport')); створює об'єкт карту.
В якості обов'язкового параметру передається посилання на HTML елемент на сторінці, в якому карта буде відображатися.

Клас VMap

VMap являється основним класом "ядра" інтернет-карти.

Конструктори

Конструктор

VMap(<HTMLElement> viewport)

Методы

Назва методу Значення, що повертається Опис

сenter() <{lng, lat}> Повертає координати поточного центру карти.

сenter(<{lng, lat}>coords) Встановлює координати поточного центру карти.

сenter(<{lng, lat}>coords, <int> zoom) Встановлює координати поточного центру карти і рівень масштабу.

сenter(<VRect> rect) Встановлює координати поточного центру карти і рівень масштабу найбільш оптимальні для заданної області.

zoom() <int> Повертає поточний рівень масштабу.

zoom(<int> index) Встановлює поточний рівень масштабу (0..18).

repaint() Перерисовка карти.

add(<VMapObject> object) Додає дочірній об'єкт.

remove(<VMapObject> object) Видаляє дочірній об'єкт.

language() <String> Повертає поточну мову карти (підтримувані мови: "ru", "ua", "en").

language(<String>lang) Встановлює поточну мову карти (підтримувані мови: "ru", "ua", "en").

clientRect() <VRect> Повертає координати поточної видимої області користувача.

Події

Подія Значення, що повертається Опис

mouseclick(<function> callback) {lng, lat} coords Клік мишею.

mousedown(<function> callback) {lng, lat} coords Натискання клавіши миші.

mouseup(<function> callback) {lng, lat} coords Відпускання клавіши миші.

mousedblclick(<function> callback) {lng, lat} coords Подвійний клік мишею.

Подія Опис

startdrag(<function> callback) Старт перетягування.

dragging(<function> callback) Перетягування.

enddrag(<function> callback) Закінчення перетягування.

Подія Опис

beforezoomchange(<function> callback) Подія відбувається до зміни масштабу. У випадку, якщо функція callback повертає false перемикання масштабу блокується.

onzoomchange(<function> callback) Подія відбувається після зміни масштабу.