"Zaufani" i "niezaufani" dostawcy POI

API DoCelu.pl standardowo jest źródłem POI od kilku dostawców. Należą do nich partnerzy biznesowi seriwsu, a także użytkownicy serwisu DoCelu.pl dodający na mapie punkty, akceptowane później przez moderatora. Każdy dostawca punktów opisany jest kilkoma parametrami:


var vendor = {
  //identyfikator dostawcy POI
  "id" :  1,
  //nazwa dostawcy
  "name" : "Emapa",
  //czy dostawca należy do grupy zaufanych
  "trusted" : true
};

POI dostarczane przez zewnętrznych dostawców są uznawane za zaufane. POI dostarczane przez naszych użytkowników posiadają status "niezaufanych", ale jest to tak naprawdę sposób odróżnienia POI dostarczanych przez firmy, od tych dostarczanych przez użytkowników, gdyż wszystkie POI dodane przez naszych użytkowników są weryfikowane, zanim będą dostępne na mapie.

Do pobierania informacji o dostępnych dostawcach poi służy:

Funkcja getVendors()

Pobiera informacje o dostępnych dostawcach. Zwraca tablicę dostawców o powyższej strukturze.

Do pobierania informacji o widocznych kategoriach dostawców służy:

Funkcja getVisibleVendorsCategories()

Pobiera informacje o widocznych kategoriach dostawców. Wynik ma postać.


var result = {
  "trusted" :  true,
  "untrusted" :  false
};

Do ustawienia widoczności kategorii dostawców służy:

Funkcja setVisibleVendorsCategories(vendorCategories)

Ustawia widoczne kategorie dostawców.

Przyjmowane parametry:

vendorCategories - Obiekt z dwoma atrybutami:


var vendorCategories = {
  "trusted" :  true,
  "untrusted" :  false
};

Na poniższym przykładzie wypiszemy informacje o dostawcach:


var vendors = DoCelu.getVendors();
var visibleVendorsCategories = DoCelu.getVisibleVendorsCategories();
var $vendorsDiv = jQuery('#vendorsDiv').html('<ul>');
for (var i in vendors) {
  var vendor = vendors[i];
  var isVisible = vendor.trusted && visibleVendorsCategories.trusted ||
	!vendor.trusted && visibleVendorsCategories.untrusted;
  $vendorsDiv.append('<li>' + vendors[i].name + ' - ' + (isVisible ? 'widoczny' : 'ukryty') + '</li>');
}
$vendorsDiv.append('</ul>');

Przy osadzaniu mapy ustawimy ją w centrum dużego miasta i włączymy widoczność pierwszej kategorii POI:


DoCelu.loadMap(document.getElementById('map'), null, function() {
  DoCelu.setMapView({
	"lon" : 18.650364875793457,
	"lat" : 54.34919061084566,
	"zoom" : 16
  });
  var cats = DoCelu.getCategories();
  DoCelu.showCategories([cats[0].id]);
});

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 visibleVendorsCategories = {
		trusted : true,
		untrusted : true
	  };

	  DoCelu.loadMap(document.getElementById('map'), null, function(){
		DoCelu.setMapView({
		  "lon" : 18.650364875793457,
		  "lat" : 54.34919061084566,
		  "zoom" : 16
		});
		var cats = DoCelu.getCategories();
		DoCelu.showCategories([cats[0].id]);
	  });

	  jQuery('#test').mousedown(function() {
		var vendors = DoCelu.getVendors();
		var visibleVendorsCategories = DoCelu.getVisibleVendorsCategories();
		var $vendorsDiv = jQuery('#vendorsDiv').html("<ul>");
		for (var i in vendors) {
		  var vendor = vendors[i];
		  var isVisible = vendor.trusted && visibleVendorsCategories.trusted ||
			!vendor.trusted && visibleVendorsCategories.untrusted;
		  $vendorsDiv.append("<li>" + vendors[i].name + ' - ' + (isVisible ? 'widoczny' : 'ukryty') + "</li>");
		}
		$vendorsDiv.append("</ul>");
	  });

	  jQuery('#trustedToggle').mousedown(function() {
		visibleVendorsCategories.trusted = visibleVendorsCategories.trusted ? false : true;
		DoCelu.setVisibleVendorsCategories(visibleVendorsCategories);
	  });

	  jQuery('#untrustedToggle').mousedown(function() {
		visibleVendorsCategories.untrusted = visibleVendorsCategories.untrusted ? false : true;
		DoCelu.setVisibleVendorsCategories(visibleVendorsCategories);
	  });
	});
//]]>
</script>