Графіка

Visicom Maps API дозволяє прорисовувати графічні примітиви.

Приклади:

Додавання на карту полілінії і полігону.

Відображення у браузері:

Прорисовка довільної лінії на карті:

// Створюємо шар
var layer = new VLayer();
map.add(layer);
var line =
{
    coords: [{
        lng: 30.5214,
        lat: 50.4650
    }, {
        lng: 30.5114,
        lat: 50.4550
    }],
    type: "line",
    style:
    {
        color: "#ff0000",
        lineWidth: 7,
        opacity: 0.4
    }
}
layer.add(line);
    
map.repaint();

Створення об'єкту VArea JSON-кодом:

// Створюємо шар
var layer = new VLayer();
map.add(layer);
// Описуємо полігон з 3-х точок
var area =
{
coords: [{lng: 30.5214, lat: 50.4650},
{lng: 30.5114, lat: 50.4550},
{lng: 30.5614, lat: 50.4550}],
type: "area",
style:
{
color: "#ff0000",
lineWidth: 7,
opacity: 0.4
},
childs: []
}
layer.add(area);
map.repaint();

Клас VLine

Ламана лінія. Використовується для прорисовки маршрутів, треків, тощо

JSON:

{
    coords: [{lng: 30.5214, lat: 50.4650}, {lng: 30.5114, lat: 50.4550}],
    type : "line",
    style:
    {
        color: "#ff0000",
        lineWidth: 7,
        opacity: 0.4
    }
}

• coords - перелік точок в лінії.
• style:
  • color - колір лінії.
  • lineWidth - ширина лінії.
  • opacity - прозорість. Задається дробовим значеням в діапазоні 0..1.

Об'єктне представлення:

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

Конструктор
VLine(<VPoint[]> array_of_points)

Методи

Назва методу	Значення, що повертається	Опис
color(<String> color)		Встановлює колір лінії (Приклади: "#ff00ff", "red", "white").
lineWidth(<int> lineWidth)		Встановлює ширину лінії в пікселях.
opacity(<float> opacity)		Встановлює ступінь прозорості для лінії в діапазоні 0..1 (Приклади: 0.7, 1.0, 0.0).
distance()	<int>	Повертає дистанцію в метрах.

Методи, які наслідуються від VMapObject

Назва методу	Значення, що повертається	Опис
visible(<Boolean> bool)		Встановлює флаг видимості об'єкту.
visible()	<Boolean>	Повертає значення флагу видимості об'єкту.
coords([{lng, lat}] coords)		Встановлює координати об'єкту.
coords()	[{lng, lat}]	Повертає координати об'єкту.
move(<int> x, <int> y)		Переміщає об'єкт на певну кількість пікселів в екранних координатах.
bounds()	<VRect>	Повертає межі об'єкту.

Клас VArea

Полігон. Використовується для відображення площинних об'єктів.

JSON:

{
    coords: [{lng: 30.5214, lat: 50.4650},
        {lng: 30.5114, lat: 50.4550},
        {lng: 30.5614, lat: 50.4550}],
    type: "area",
    style:
    {
        color: "#ff0000",
        opacity: 0.4
    }
}

• coords - масив точок в полігоні.
• style:
  • color - колір заливки.
  • opacity - прозорість. Задається дробовим значенням в диапазоні 0..1.

Об'єктне представлення:

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

Конструктор
VArea([{lng, lat}] coords)

Методи

Назва методу	Опис
color(<String> color)	Встановлює колір полігону (приклади: "#ff00ff", "red", "white").
opacity(<float> opacity)	Повертає/встановлює ступінь прозорості. Для полігону це значення за-замовчуванням дорівнює 0,35.

Методи, які наслідуються від VMapObject

Назва методу	Значення, що повертається	Опис
visible(<Boolean> bool)		Встановлює флаг видимості об'єкту.
visible()	<Boolean>	Повертає значення флагу видимості об'єкту.
coords([{lng, lat}] coords)		Встановлює координати об'єкту.
coords()	[{lng, lat}]	Повертає координати об'єкту.
move(<int> x, <int> y)		Переміщає об'єкт на певну кількість пікселів в екранних координатах.
bounds()	<VRect>	Повертає межі об'єкту.