Wyszukiwanie POI w prostokącie

API pozwala na wyszukiwanie POI w obszarze ograniczonym dwoma południkami i dwoma równoleżnikami, co przy spłaszczeniu kuli ziemskiej do siatki mapy daje kształt prostokąta.

Funkcja searchPoiInRectangle(categories, leftTop, rightBottom, keyword, page, results[, callback])

Wyszukuje POI w prostokącie według zadanych kryteriów.

Przyjmowane parametry

1. categories - Liczba całkowita będąca identyfikatorem kategorii POI w której szukamy,
2. leftTop - Obiekt ze współrzędnymi lewego górnego rogu obszaru wyszukiwania, np.:
   

   
   leftTop = {
     "lon" : 20,
     "lat" : 52
   }
   

3. rightBottom - obiekt ze współrzędnymi prawego dolnego rogu obszaru wyszukiwania, np.:
   

   
   leftTop = {
     "lon" : 21,
     "lat" : 51
   }
   

4. keyword - Fraza, po której szukamy - np. nazwa POI lub typ obiektu,
5. page - Strona wyników wyszukiwania (liczona od zera),
6. results - Liczba wyszukanych POI na stronę,
7. callback - Funkcja wywoływana po pobraniu wyników. Jeśli nie zostanie zdefiniowana, to wywołana zostanie funkcja callBacks.searchPoiInRectangle z obiektu konfiguracyjnego API.

Jeden z parametrów categories i keywords, oraz parametry leftTop i rightBottom są obowiązkowe.

Przykładowo będziemy chcieli wyszukać sklepy na aktualnym widoku mapy:

<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() {
			var leftTop = DoCelu.getLeftTopCorner();
			var rightBottom = DoCelu.getRightBottomCorner();
			DoCelu.searchPoiInRectangle(null, leftTop, rightBottom, "sklep", 0, 50);
		});
	});
//]]>
</script>
	

Po wykonaniu takiego kodu POI zostaną wyszukane i zaprezentowane na mapie.