Pobieranie szczegółów POI

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 getPoiDetails(pois, callBack)

Funkcja pobiera szczegółowe dane POI określone przez identyfikator i bazę POI. Po pobraniu danych wywoływana zostaje funkcja callBack - jeden raz dla każdej bazy POI. W jednym wywołaniu znajdują się szczegóły wszystkich POI z danej bazy, o którą pytaliśmy.

Przyjmowane parametry

pois - Tablica obiektów identyfikujacych POI. Każdy obiekt ma postać:


var poi = {
  //identyfikator POI
  "poiId" : 859148,
  //identyfikator bazy POI
  "poiBase" : "docelu"
};

callBack - Funkcja wywoływana po pobraniu danych. Funkcja zostanie wywołana jeden raz dla każdej odpytywanej bazy POI. Funkcja przyjmuje dwa parametry:

retStatus - status odpowiedzi


retStatus = {
  failed: false, //wartość boolowska, czy pobranie danych zawiodło
  errDesc: null, //ciąg znaków, opis ewntualnego błędu
  exception: null //ewentualny obiekt wyjątku XMLHttpRequest
}

response - odpowiedź


response = {
  amount: 2, //liczba wszystkich POI pasujacych do wyników wyszukiwania
  pois: [ ... ] //tablica ze stroną wyszukanych POI
}

Obiekt z tablicy zwrócony z funkcji getPoiDetails ma postać:


"poi" :  {
  //dodatkowe infotmacje
  "description" :  "Wirtualna Polska plasuje się w absolutnej czołówce najczęściej odwiedzanych i najbardziej znanych miejsc w polskim Internecie. WP.pl to interaktywna platforma komunikacji, informacji i transakcji elektronicznych. Portal jest pierwszym wyborem wielu polskich Internautów, poszukujących, poprzez Sieć, informacji, wszechstronnej wiedzy, narzędzi ułatwiających porozumiewanie się, czy pragnących błyskawicznie zawrzeć elektroniczne transakcje.",
  //unikalny identyfikator POI
  "poiId" :  859148,
  //nazwa punktu
  "name" :  "Wirtualna Polska S.A.",
  //id dostawcy
  "vendorId" :  3,
  //kategoria
  "categoryId" :  429,
  "poiGeom" :  {
    //szerokość geograficzna
    "lat" :  54.3689,
    //długość geograficzna
    "lon" :  18.6079
  },
  //miejscowość
  "locality" :  "Gdańsk",
  //nazwa ulicy
  "road" :  "Traugutta",
  //numer ulicy
  "roadNo" :  "115a",
  //telefon
  "contact" :  "(+48 58) 52 15 600",
  //adres www
  "www" :  "www.wp.pl",
  //identyfikator POI w bazie dostawcy
  "vendorPoiId" :  859148,
  //wartość boolowska informująca o weryfikacji przez moderatora
  "verifyStatus" :  null,
  //adres url ikonki
  "iconUrl" :  "http://i.wp.pl/a/i/finanse/logozr/WP.gif",
  //słowa kluczowe
  "keywords" :  "wp, wirtualna, polska, portal",
  //kod pocztowy
  "postCode" :  "80-226",
  //branża
  "branch" :  "Internet",
  //czas pracy
  "whMonFriFrom" :  null,
  //czas pracy
  "whMonFriTo" :  null,
  //czas pracy
  "whSatFrom" :  null,
  //czas pracy
  "whSatTo" :  null,
  //czas pracy
  "whSunFrom" :  null,
  //czas pracy
  "whSunTo" :  null,
  //akceptacja kart płatniczych; wartość boolowska
  "cardAccept" :  false,
  //opinie; wartość boolowska
  "showOpinions" :  true,
  //czy wizytówka ma być prezentowana na stronie PKT
  "isVendorClient" :  null,
  //identyfikator bazy POI
  "poiBase" :  "docelu"
}

Przykładowo pobierzemy szczegółowe dane następującego POI i wyświetlimy je pod mapą:


<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
	jQuery(document).ready(function() {
		function poiDetailsCallBack(retStatus, response) {
		  if (!retStatus.failed) {
		    if (response.amount > 0 && jQuery.isArray(response.pois)) {
		      var dPoi = response.pois.pop();
		      jQuery('#poisDiv').html('<pre><code class="js">' + jQuery.dump(dPoi, 0, "poi") + '</code></pre>');
		      jQuery('#poisDiv').find('code').chili();
		    }
 		  }
		}

		var poisArray = [];
		var poi = {
		  //identyfikator POI
		  "poiId" : 859148,
		  //identyfikator bazy POI
		  "poiBase" : "docelu"
		};
		poisArray.push(poi);
		DoCelu.getPoiDetails(poisArray, poiDetailsCallBack);
	});
//]]>
</script>

Szczegóły POI: