Wyszukiwanie budynku

Funkcja searchBuilding(streetName, streetNo, cityId[, callback])

Wyszukuje położenie konkretnego budynku.

Przyjmowane parametry

1. streetName - Nazwa (lub jej fragment) ulicy, na której szukamy budynku,
2. streetNo - Numer szukanego budynku,
3. cityId - Identyfikator miejscowości, w której szukamy (uzyskamy go wywołujac wcześniej searchCity),
4. callback - Funkcja wywoływana po pobraniu wyników. Jeśli nie zostanie zdefiniowana, wywołana zostanie funkcja callBacks.searchBuilding z elementu konfiguracyjnego API.

W celu przechwycenia wyników wyszukiwania i prezentacji ich np. w HTML'u należy zdefiniować w konfiguracji funkcję callBack. Jeśli nie zostanie ona zdefiniowana pierwszy wyszukany wynik zostanie zaprezentowany na mapie.

Funkcja callback przyjmuje dwa parametry:

1. ret - Status odpowiedzi,
   

   
   ret = {
     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 = {
     "city" : { ... }, //obiekt miasta w którym szukaliśmy - 
   //opis w funkcjonalności wyszukiwania miast
     "street" : { ... }, //obiekt ulicy na której szukaliśmy - 
   //opis w funkcjonalności wyszukiwania ulic
     "streetNumber" :  115, //Numer budynku, którego szukaliśmy
     "point": {
       "lat" : 54.36999130249, //szerokość geograficzna
       "lon" : 18.608028411865 //długość geograficzna
     }
   }
   

Przykład:

<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
	jQuery(document).ready(function() {
		DoCelu.loadMap(document.getElementById('map'), null, function() {
			function searchBuildingCallback(ret, response) {
			  if (ret.failed) {
				//wystąpił błąd
			  } else {
				alert("dł. " + response.point.lon + "\nszer. " + response.point.lat);
			  }
			  //zwracamy null - wynik pojawi się na mapie
			  return;
			}
			var config = {
			  callBacks : {
				searchBuilding : searchBuildingCallback
			  }
			};
			jQuery('#test').mousedown(function() {
			  DoCelu.searchBuilding("Traugutta", 115, 48855);
			});
		});
	});
//]]>
</script>
	

Funkcję wywołamy z parametrami:

DoCelu.searchBuilding("Traugutta", 115, 48855);