Zarządzanie kategoriami

Ten dokument nie wyjaśnia wszystkich wątpliwości? Szczegółowa dokumentacja techniczna API DoCelu.pl

Sprawdź toczące się dyskusje na Forum API DoCelu.pl

Funkcja addCategory(category[, parentCategoryId])

Dodaje nową kategorię POI. Obiekt kategorii POI może mieć zdefiniowane podkategorie i warstwy.

Przyjmowane parametry:

category - Obiekt nowej kategorii POI,

parentCategoryId - Identyfikator kategorii, która ma zostać nadrzędną dla nowododawanej. Jeśli nie zdefiniowany lub null dodaje kategorię na najwyższym poziomie.

Przy wywołaniu metody addCategory, jeśli podamy id już istniejącej kategorii, to jej dane zostaną nadpisane. Aby uniknąć takiej sytuacji należy podać unikatową wartość id. W tym celu możemy skorzystać z funkcji:

Funkcja getAvailableCategoryId()

Zwraca pierwszą wolną liczbę naturalną.

Przykładowy kod i efekt jego zastosowania:


<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
	jQuery(document).ready(function() {
		var $categories = jQuery('#categories').show().empty();
		var categories = DoCelu.getCategories();
		var firstCategoryId = null;
		//wypiszę główne kategorie
		var list = '';
		for (var i in categories) {
		  //zapamiętuje id pierwszej kategorii
		  if (null === firstCategoryId) {
			firstCategoryId = categories[i].id;
		  }
		  list += ("<li>ID: " + categories[i].id +
			" - NAZWA: " + categories[i].name +
			" - PODKATEGORIE: " + categories[i].subcategories.length + "</li>");
		}
		$categories.append("<ul>" + list + "</ul>");

		//dodam własną podkategorię do pierwszej kategorii
		var categoryToAdd = {
		  "name" : "Moja podkategoria",
		  "subcategories" : [],
		  "iconUrl" : "http://i.wp.pl/a/i/mapy/cat004/turystyka.png",
		  "defaultVisibility" : 0,
		  "layers" : [],
		  "id" : DoCelu.getAvailableCategoryId()
		};
		DoCelu.addCategory(categoryToAdd, firstCategoryId);
		//jeszcze raz wypisuję kategorie
		categories = DoCelu.getCategories();
		$categories.append("<b> Dodałem podkategorię </b>");
		var list = '';
		for (var i in categories) {
		  list += ("<li>ID: " + categories[i].id +
			" - NAZWA: " + categories[i].name +
			" - PODKATEGORIE: " + categories[i].subcategories.length + "</li>");
		}
		$categories.append("<ul>" + list + "</ul>");


		//teraz dodam kategorię na najwyższym poziomie
		var categoryToAdd = {
		  "name" : "Moja główna kategoria",
		  "subcategories" : [],
		  "iconUrl" : "http://i.wp.pl/a/i/mapy/cat004/turystyka.png",
		  "defaultVisibility" : 0,
		  "layers" : [],
		  "id" : DoCelu.getAvailableCategoryId()
		};
		DoCelu.addCategory(categoryToAdd);
		$categories.append("<b> Dodałem główną kategorię </b>");
		categories = DoCelu.getCategories();
		var list = '';
		for (var i in categories) {
		  list += ("<li>ID: " + categories[i].id +
			" - NAZWA: " + categories[i].name +
			" - PODKATEGORIE: " + categories[i].subcategories.length + "</li>");
		}
		$categories.append("<ul>" + list + "</ul>");


		//teraz usunę wszystkie kategorie
		DoCelu.clearCategories();
		$categories.append("<b> Wyczyściłem kategorie </b>");
		categories = DoCelu.getCategories();
		var list = '';
		for (var i in categories) {
		  list += ("<li>ID: " + categories[i].id +
			" - NAZWA: " + categories[i].name +
			" - PODKATEGORIE: " + categories[i].subcategories.length + "</li>");
		}
		$categories.append("<ul>" + list + "</ul>");
	});
//]]>
</script>

Wypróbujmy zatem działanie w praktyce: