Wyszukiwanie POI według adresu i opisu

Funkcja searchPoiByAddress(locality, street, streetNo, keyword, categories, page, results[, callBack])

Wyszukuje POI według zadanych kryteriów. Z tej funkcji najczęściej skorzystamy do obsługi formularzy wyszukiwania.

Przyjmowane parametry

1. locality - Nazwa miasta, w którym szukamy,
2. street - Nazwa ulicy, na której szukamy,
3. streetNo - Numer budynku, w którym mieści się szukany POI,
4. keyword - Fraza, której szukamy - skojażona z POI,
5. categories - Identyfikatory kategorii, w których szukamy,
6. page - Numer strony wyników wyszukiwania, liczony od zera,
7. results - Liczba wyników wyszukiwania na stronę
8. callBack - Funkcja wywoływana po pobraniu wyników. Jeśli nie zostanie zdefiniowana, to wywołana zostanie funkcja z konfiguracji callBacks.searchPoiByAddress

Co najmniej jeden z parametrów keyword lub categories musi być ustawiony. Pozostałe mogą być nullami lub pustymi stringami.

My nie mamy konkretnych planów na wieczór, więc wyszukamy sobie puby w Gdańsku

DoCelu.searchPoiByAddress("Gdańsk", null, null, "Pub", null, 0, 20);

W celu przechwycenia wyników wyszukiwania i prezentacji ich np. w HTML'u zdefiniowana zostanie fukcja callBack przyjmującą 2 parametry:

1. 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
   }
   

2. response - Odpowiedź.
   

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

Zostanie zdefiniowana funkcja callBack i osadzona na mapie z odpowiednią konfiguracją (alternatywnie funkcję callBack można przekazać jako parametr wywołania funkcji wyszukiwania):

<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
	jQuery(document).ready(function() {
		function searchPoiByAddressCallBack(retStatus, response) {
		  if (retStatus.failed) {
			//coś się nie udało
		  } else {
			$resultDiv = jQuery('#resultDiv').html('<ol></ol>');
			for (var i in response.pois) {
			  var poi = response.pois[i];
			  $resultDiv.find('ol').append('<li>' + poi.name + ' - ' + poi.locality + ', ' + poi.road + ' ' + poi.roadNo + '</li>');
			}
			//jeśli nie chcemy, by wyniki pokazane zostały na mapie zwracamy false
			//return false;
		  }
		}

		var config = {
		  "callBacks" : {
			"searchPoiByAddress" : searchPoiByAddressCallBack
		  }
		};

		DoCelu.loadMap(document.getElementById('map'), config, function() {
			var view = {
				"lon" : 19.611698,
				"lat" : 52.370658,
				"zoom" : 5
			};
			DoCelu.setMapView(view);
		});
	});
//]]>
</script>
	

Wyszukane POI