Teksty

Funkcja służy do dodawania tekstów na mapie.

Przyjmowane parametry

1. texts - Tablica tekstów. Każdy tekst musi posiadać conajmniej 1 punkt (środek). 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.addTexts 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 tekstu:

var point = {
  "lon" : 18.630409240722656,
  "lat" : 54.334943271492
};

var text = {
    "id" : 1, // unikalne id
    "categoryId" : 1, // id warstwy na której leżeć ma obiekt
	"point" : point, // punkt (środek)
	"text" : "testowy tekst", // tekst
	"textColor" : "0x0000ff", // kolor tekstu
	"textOpacity" : 1, // przeźroczystość
	"size" : 25, // wielkość tekstu
	"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.addTexts([text]);

Można przechwycić wynik operacji rysowania tekstu. Zdefiniujemy zatem jednoparametrową funkcję addTextsCallback 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 addTextsCallback(ret) {
	var $textsEventsDiv = jQuery('#textsEvents');
	var html = '<h3>Tekst dodany.</h3>';
	$textsEventsDiv.html(html);
	return;
}

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

var config = {
  "callBacks" : {
    "addTexts" : addTextsCallback
  }
};

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 tekstu