Wielolinie

Funkcja służy do dodawania polilinii na mapie.

Przyjmowane parametry

1. polylines - Tablica obiektów polilinii. Każda polilinia musi posiadać conajmniej 2 punkty. Każdy punkt musi mieć podaną długość geograficzną (lon) i szerokość geograficzną (lat).
   
2. callBack - funkcja wywoływana po pobraniu wyników. Jeśli nie zostanie zdefiniowana, to wywołana zostanie funkcja callBacks.addPolylines z obiektu konfiguracyjnego API.

Tryby dodawania obiektów

1. Single - przeznaczony do dodawania/usuwania małej ilości obiektów. Charakteryzuje się tym, że we flashu obiekty nie są spłaszczane. Dzięki temu nie ma potrzeby rysowania od nowa wszystkich obiektów po dodaniu lub usunięciu jednego z nich. Jednak przez brak spłaszczenia nie jest to rozwiązanie wydajne przy dużej ilości obiektów.
   
2. Bulk - przeznaczony do dodawania/usuwania dużej ilości obiektów. Charakteryzuje się tym, że we flashu obiekty są spłaszczane, co powoduje zwiększenie wydajności przy dużej liczbie obiektów. Dodanie lub usunięcie pojedynczego obiektu skutkuje jednak tym, że wszystkie widoczne obiekty muszą być przerysowane od nowa.

Przykład wywołania dodania polilini:

var point1 = {
  "lon" : 18.630409240722656,
  "lat" : 54.334943271492
};
var point2 = {
  "lon" : 19.97314453125,
  "lat" : 53.76007817077558
};
var point3 = {
  "lon" : 21.02611541748047,
  "lat" : 52.24472480162969
};
var points = [];
points[0] = point1;
points[1] = point2;
points[2] = point3;

var polyline = {
	"id" : 1, // unikalne id
	"categoryId" : 1, // id warstwy na której leżeć ma obiekt
	"points" : points, // punkty składowe
	"lineColor" : "0x00ff00", // kolor lini
	"lineOpacity" : 1, // przeźroczystość lini
	"lineSize" : 1, // grubość lini (w pikselach)
	"mode" : "bulk", // tryb dodawania obiektów
	"zoomFrom" : 1, // minimalne powiększenie, od którego widać obiekt
	"zoomTo" : 15, // maksymalne powiększenie, do którego widać obiekt
	"externalOver" : "mouseOver", // funkcja uruchamiana na zdarzenie onmouseover
	"externalOut" : "mouseOut" // funkcja uruchamiana na zdarzenie onmouseout
};
DoCelu.addPolylines([polyline]);

Można przechwycić wynik operacji rysowania polilini. Zdefiniujemy zatem jednoparametrową funkcję addPolylinesCallback z parametrem:

1. returnStatus - obiekt zawierający status odpowiedzi

Jeśli funkcja zwróci wartość false, to wynik nie zostanie wyświetlony na mapie.
Przykład definicji funkcji:

function addPolylinesCallback(ret) {
	var $polylinesEventsDiv = jQuery('#polylinesEvents');
	var html = '<h3>Polilinia dodana.</h3>';
	$polylinesEventsDiv.html(html);
	return;
}

Informację, która funkcja ma zostać wywołana należy podać w obiekcie konfiguracyjnym mapy:

var config = {
  "callBacks" : {
    "addPolylines" : addPolylinesCallback
  }
};

Obiekt ten można przekazać na etapie ładowania mapy (funkcja loadMap) lub wywołując funkcję loadConfig. W przykładzie zrobimy to na etapie ładowania mapy.

DoCelu.loadMap(document.getElementById('map'), config);

Dodawanie polilini