EMAPI.Map
Instancje klasy EMAPI.Map są interaktywnymi mapami osadzanymi w aplikacjach internetowych. Nowa mapa tworzona jest za pomocą konstruktora EMAPI.Map. Wyszukiwanie danych na mapie jest realizowane za pomocą instancji klasy EMAPI.Finder.
Dodatkowe warstwy obiektów nakłada się na mapę za pomocą instancji klas EMAPI.VectorLayer lub EMAPI.ClusterLayer.
Podsumowanie
EMAPI.Map | Instancje klasy EMAPI.Map są interaktywnymi mapami osadzanymi w aplikacjach internetowych. |
Functions | |
EMAPI.Map | Konstruktor nowej instancji mapy klasy EMAPI.Map. |
addMapAction | Dodaje nową akcję do menu konteksowego mapy. |
addMapAction | Dodaje nową akcję do panelu narzędziowego mapy. |
removeMapAction | Usuwa akcję z menu konteksowego mapy. |
addLayer | Dodaje nową warstwę obiektów na mapę. |
removeLayer | Usuwa z mapy wskazaną warstwę obiektów. |
getBounds | Zwraca współrzędne geograficzne prostokąta aktualnego widoku mapy. |
setBounds | Dostosowuje aktualny widok mapy do zaprezentowania prostokąta o podanych współrzędnych geograficznych. |
setMapType | Zmienia aktualny typ mapy. |
getCenterPos | Zwraca współrzędne geograficzne punktu środkowego aktualnego widoku mapy. |
setCenterPos | Centruje aktualny widok mapy względem punktu o podanych współrzędnych geograficznych. |
setCallback | Ustawia funkcję obsługi zdarzenia na mapie. |
categoryObjects | Zwraca do zarządzania obiektami statycznymi, np. |
getZoom | Zwraca poziom powiększenia aktualnego widoku mapy. |
updateSize | Odświeża mapę po zmianie rozmiaru okna. |
convertLonLatToScreen | Konwertuje współrzędne geograficzne na ekranowe punktu z aktualnego widoku mapy. |
convertScreenToLonLat | Konwertuje współrzędne ekranowe na geograficzne punktu z aktualnego widoku mapy. |
getVersion | Zwraca wersję danych mapy. |
isChanging | Zwraca informacje o statusie mapy. |
EMAPI.Map
Konstruktor nowej instancji mapy klasy EMAPI.Map.
Parametry
div | {String} Identyfikator elementu na stronie, który ma zawierać mapę. |
token | {String} Identyfikator użytkownika. |
options | {Object} Dodatkowe parametry mapy: mapType (wybór wyświetlanej mapy: ‘std’ - mapa standardowa, ‘hipso’ - mapa hipsometryczna, ‘hybrid’ - mapa ze zdjęciami satelitarnymi), flagi logiczne: noZoom (brak panelu powiększania), noScale (brak wskaźnika skali), noMiniMap (brak okna nawigatora mapy), |
addMapAction
Dodaje nową akcję do menu konteksowego mapy.
Parametry
index | {Integer} Pozycja w menu kontekstowym, na której ma pojawić się nowa akcja (wartość >= 0). |
action | {String} Tytuł akcji. |
icon | {String} URL ikony dla akcji. |
callback | {Function} Funkcja uruchamiana po wybraniu akcji z menu kontekstowego. |
addMapAction
addMapAction: function( | index, | | action, | | icon, | | callback | ) |
|
Dodaje nową akcję do panelu narzędziowego mapy.
Parametry
index | {Integer} Pozycja w panelu, na której ma pojawić się nowa akcja (wartość >= 0). |
action | {EMAPI.Actions.MapClick} Akcja. |
removeMapAction
removeMapAction: function( | index | ) |
|
Usuwa akcję z menu konteksowego mapy.
Parametry
index | {Integer} Pozycja w menu kontekstowym, na której znajduje się przeznaczona do usunięcia akcja (wartość >= 0). |
addLayer
addLayer: function( | layer | ) |
|
Dodaje nową warstwę obiektów na mapę.
Parametry
removeLayer
removeLayer: function( | layer | ) |
|
Usuwa z mapy wskazaną warstwę obiektów.
Parametry
getBounds
Zwraca współrzędne geograficzne prostokąta aktualnego widoku mapy.
Wynik
{EMAPI.Bounds} Obiekt typu EMAPI.Bounds reprezentujący zakres mapy.
setBounds
setBounds: function( | bounds | ) |
|
Dostosowuje aktualny widok mapy do zaprezentowania prostokąta o podanych współrzędnych geograficznych.
Parametry
bounds | {EMAPI.Bounds} Obiekt typu EMAPI.Bounds reprezentujący żądany obszar mapy. |
setMapType
setMapType: function ( | mType | ) |
|
Zmienia aktualny typ mapy.
Parametry
mType | {String} Typ wyświetlanej mapy (‘std’ - mapa standardowa, ‘hipso’ - mapa hipsometryczna, ‘hybrid’ - mapa ze zdjęciami satelitarnymi). |
getCenterPos
Zwraca współrzędne geograficzne punktu środkowego aktualnego widoku mapy.
Wynik
{EMAPI.LonLat} Obiekt typu EMAPI.LonLat reprezentujący współrzędne zwracanego punktu.
setCenterPos
setCenterPos: function( | center, | | zoom | ) |
|
Centruje aktualny widok mapy względem punktu o podanych współrzędnych geograficznych.
Parametry
center | {EMAPI.LonLat} Obiekt typu EMAPI.LonLat reprezentujący współrzędne geograficzne żądanego punktu. |
zoom | {Integer} Żądane powiększenie (wartość z zakresu 0-17). |
setCallback
setCallback: function( | type, | | callback | ) |
|
Ustawia funkcję obsługi zdarzenia na mapie.
Parametry
type | {String} Typ zdarzenia (mapChange, objClick, objOver, objOut, objDragBegin, objDragEnd, onCategoriesChange, info, contextMenu). |
callback | {Function} Funkcja uruchamiana podczas zdarzenia. |
categoryObjects
categoryObjects:function() |
Zwraca do zarządzania obiektami statycznymi, np. POI.
Wynik
{EMAPI.CategoryObjects} Obiekt umożliwiający zarządzanie obiektami statycznymi pojawiającymi się na mapie (dotyczy to obiektów POI oraz dodatkowych obiektów klienta ładowanych automatycznie).
getZoom
Zwraca poziom powiększenia aktualnego widoku mapy.
Wynik
{Integer} Powiększenie mapy (wartość z zakresu 0-17).
updateSize
Odświeża mapę po zmianie rozmiaru okna.
convertLonLatToScreen
convertLonLatToScreen: function( | lonLat | ) |
|
Konwertuje współrzędne geograficzne na ekranowe punktu z aktualnego widoku mapy.
Parametry
lonLat | {EMAPI.LonLat} Obiekt typu EMAPI.LonLat reprezentujący współrzędne geograficzne punktu. |
Wynik
{EMAPI.Pixel} Obiekt typu EMAPI.Pixel reprezentujący współrzędne ekranowe punktu.
convertScreenToLonLat
convertScreenToLonLat: function( | px | ) |
|
Konwertuje współrzędne ekranowe na geograficzne punktu z aktualnego widoku mapy.
Parametry
px | {EMAPI.Pixel} Obiekt typu EMAPI.Pixel reprezentujący współrzędne ekranowe punktu. |
Wynik
{EMAPI.LonLat} Obiekt typu EMAPI.LonLat reprezentujący współrzędne geograficzne punktu.
getVersion
getVersion: function ( | callback | ) |
|
Zwraca wersję danych mapy.
Parametry
callback | {Function} Funkcja, do kórej przekazywana jest wersja mapy. |
isChanging
Zwraca informacje o statusie mapy.
Wynik
{Boolean} Statusu mapy (true lub false).