Wielokąty

Funkcja służy do dodawania wielokątów na mapie.

Przyjmowane parametry

1. polygons - Tablica obiektów wielokątów. Każdy wielokąt musi posiadać conajmniej 3 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.addPolygons z obiektu konfiguracyjnego API.

Tryby dodawania obiektów

1. Single - przeznaczony do dodawania/usuwania małej liczby 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 liczbie obiektów.
   
2. Bulk - przeznaczony do dodawania/usuwania dużej liczby 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 wielokąta:

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 polygon = {
	"id" : 1, // unikalne id
	"categoryId" : 1, // id warstwy na której leżeć ma obiekt
	"points" : points, // punkty składowe
	"lineColor" : "0x000000", // kolor lini
	"lineOpacity" : 1, // przeźroczystość lini
	"lineSize" : 1, // grubość lini (w pikselach)
	"fillColor" : "0x00ff00",  // kolor wypełnienia
	"fillOpacity" : 0.7, // przeźroczystość wypełnienia
	"layer" : "<div style=\"width:226px;height:76px;background: #ffffff
			url('http://docelu.pl/i/docelu.gif')
			no-repeat center center\" />", // layerek
	"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.addPolygons([polygon]);

Można przechwycić wynik operacji rysowania wielokąta. Zdefiniujemy zatem jednoparametrową funkcję addPolygonsCallback 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 addPolygonsCallback(ret) {
	var $polygonsEventsDiv = jQuery('#polygonsEvents');
	var html = '<h3>Polygon dodany.</h3>';
	$polygonsEventsDiv.html(html);
	return;
}

Informację, która funkcja ma zostać wywołana należy podać w obiekcie konfiguracyjnym mapy. W obiekcie tym definiujemy również opóźnienie w wyświetleniu chmurki dla kształtu:

var config = {
  "features" : {
    "detailsShowDelay" : 500
  },
  "callBacks" : {
    "addPolygons" : addPolygonsCallback
  }
};

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 wielokąta