Alle Ereignisse werden über das globale Objekt glbEventObject ausgelöst.
- activeShapeFeatureType
- currentMapScale : int
- currentSessionId : string
- currentSrs : int
- extent : ExtentObj
- generalCopyrightText : string
- initialized : bool
- lastMapServerError : object
- locked : bool
- mapSize : object
- markerShape : ShapeObject
- overlays : MapOverlayManager
- overViewMapIsOpen : bool
- ready : bool
- shape : ShapeObject
- showPointMarkerConfig : object
- simpleMapActive : bool
- simpleMapAvailable : bool
- simpleMapCopyrightText : string
- tileMap : TileLayerManager
- tileMapZPosition
- activateSimpleMap(preventAutoRefresh)
- addAdditionalArgsToLastCommand(args)
- cleanUpMouseAction()
- clearRedline(name)
- clearSelection()
- closeOverviewMap(suppressAnimation)
- deactivateSimpleMap()
- displayGuiElements(elements, show)
- getCurrentMapTool() : string
- getMapToolMode() : string
- getWebMapHandlerUrl(allowCaching) : string
- hideInfoDiv()
- isTileMapAvailable()
- makeRedline(geom, symbolNumber, name, mode, rop2Code)
- openOverviewMap(suppressAnimation)
- pan(x, y)
- refreshMap()
- resizeMap(size)
- screenToGeo(x, y, useLastFixedExtent) : object
- setFilter(layerFilter, clearSel, callback)
- setImageType(imageType)
- setInitialImageType()
- setLayerList(layerList)
- setScale(scale)
- setSrs(epsgCode)
- setTileMapZPosition(position)
- setTool(args) : string
- showInfoDiv(config)
- showObject(layer, iSqlWhere, zoomBehavior, offset)
- transformPoint(x, y, fromEpsgCode, toEpsgCode, callback)
- transformPoints(points, fromEpsgCode, toEpsgCode, callback)
- zoomIn(xMin, yMin, xMax, yMax)
- zoomInSimple()
- zoomOut(x, y)
- zoomOutSimple()
- zoomToDefaultExtent()
- zoomToLayers(layerList)
- zoomToPoint(x, y, offset, showMarker)
object activeShapeFeatureType |
Aktueller Feature-Type, der für die Erstellung von Geometrien mit dem Redlinewerkzeug benutzt wird. |
int currentMapScale |
(readonly) Aktueller Kartenmaßstab |
string currentSessionId |
(readonly) Aktuelle Id der Mapserver-Session |
int currentSrs |
(readonly) EPSG Code des aktuellen geografischen Bezugssystems |
ExtentObj extent |
(readonly) Aktuelle geografische Ausdehnung der Karte |
string generalCopyrightText |
Allgemeiner Copyright-/Hinweis-Text der immer am unteren Kartenrand angezeigt wird. |
bool initialized |
(readonly) Gibt Auskunft darüber, ob das Karten-Control den Status "initialisiert" erreicht hat. Die Karte gilt als initialisiert, wenn die Kartengröße gesetzt ist und alle internen Einstellungen beleget sind, jedoch schon vor dem Anfordern der ersten Karte. |
object lastMapServerError |
(readonly) Fehlermeldung des letzten Requests {type, message}. Wenn diese Eigenschaft null ist, dann lief der letzte Request fehlerfrei. |
bool locked |
(readonly) Kartenanforderung läuft gerade und das Control ist blockiert. |
object mapSize |
(readonly) derzeitige Kartengröße als Objekt mit {width, height} |
ShapeObject markerShape |
(readonly) Shape-Objekt, vorgesehen für Markierungs- und Kennzeichnungszwecke im Map-Control. |
MapOverlayManager overlays |
(readonly) Manager für die Überlagerung der Karte mit eigenen (aktiven) Inhalten |
bool overViewMapIsOpen |
(readonly) Übersichtskarte ist gerade geöffnet. |
bool ready |
(readonly) Gibt Auskunft darüber, ob das Karten-Control vollständig für clientseitige Interaktionen zur Verfügung steht. Dies ist der Fall, wenn die erste Karte vollständig geladen wurde. |
ShapeObject shape |
(readonly) Shape-Objekt, vorgesehen für das Redlining im Map-Control. |
object showPointMarkerConfig |
Ein Fragment mit der Konfiguration eines Overlay-Symbols, welches als Marker verwendet werden soll, z.B. von der zoomToPoint Methode. z.B.: {html: ..., id: ... zIndex: ...} gx und gy werden später automatisch eingesetzt |
bool simpleMapActive |
(readonly) Die "einfache" Karte ist gerade aktiv. |
bool simpleMapAvailable |
(readonly) Gibt Auskunft darüber, ob überhaupt eine "einfache" Karte konfiguriert wurde und clientseitig vorhanden ist. |
string simpleMapCopyrightText |
Copyright-/Hinweis-Text der am unteren Kartenrand angezeigt wird, wenn die einfache Karte angeschaltet ist. |
TileLayerManager tileMap |
(readonly) Manager der Tile Ebenen im Control. (Steht nur zur Verfügung, wenn dieses Feature korrekt initialisiert wurde.) |
object tileMapZPosition |
(readonly) Gibt Auskunft über die Position der Kachelkarte gegenüber der "einfachen" Karte. Mögliche Werte sind "bottom" oder "top". |
Aktiviert die "einfache" Karte.
(siehe auch deactivateSimpleMap)
preventAutoRefresh |
Fügt an das zuletz abgesetzte Kartenkommando noch weitere Parameter an. Dies wird u.U. benötigt, wenn für bestimmte Kommandos noch ein serverseitiges Processing erfolgt. (Events des serverseitigen MapActionManager Objektes)
object | args |
Objekt mit Schlüssel - Wert Paaren, die dem letzten Befehl noch angefügt werden |
Diese Funktion sollte unbedingt aufgerufen werden, wenn die übliche Mausaktionsfolge mousedown - mousemove - mouseup in der Karte von außen unterbrochen wurde. Dies kann z.B. nach Reaktionen auf Events des glbMap.shape-Objektes nötig sein, in denen alert oder confirm benutzt wird und die es dem Nutzer ermöglichen die Maustaste loszulassen, ohne das dass Map-Control dies registrieren kann.
Entfernt alle oder eine benannte Gruppe von Redlinegeometrien aus der dynamischen Karte
(refreshMap erforderlich)
string | [name] |
optionaler Name, um diese Geometrie unter diesem Namen anzulegen bzw. einer bereits so benannten Gruppe zuzuordnen (Standardwert: '') |
Hebt eine evtl. bestehende Selektion auf und entfernt die Selektionsmarkierung aus der Karte.
(refreshMap erforderlich)
Schließt die Übersichtskarte
(siehe auch openOverviewMap)
bool | suppressAnimation |
Die Animation des Vorganges wird unterbunden wenn true übergeben wird. |
Deaktiviert die "einfache" Karte.
Diese Funktion sollte nur benutzt werden, wenn statt dessen Tile-Layer angezeigt werden.
(siehe auch activateSimpleMap)
Interaktionselemente ein-/ausblenden
string/string[] | elements |
ElementId oder Array von diesen: "zoomSlider", "navigationCross", "toolbar", "overviewMap" |
bool | show |
spezifizierte Elemente anzeigen oder ausblenden (true bedeuted anzeigen, false ausblenden) |
Gibt das momentan aktive Kartenwerkzeug zurück.
string | das momentan aktive Kartenwerkzeug |
Gibt den momentan aktive Modus zurück, der zur Bestimmung der letztlich tatsächlich ausgeführten Kartenaktion benutzt wird (MOUSEACTION - automatisch anhand der Mausaktion des Nutzers, EXPLICIT - das gesetzte Kartenwerkzeug wird benutzt).
string | MOUSEACTION|EXPLICIT |
Gibt die BasisUrl für Aufrufe des MapHandlers zurück. Diese ist i.d.R. relativ, außer das Control läuft CrossDomain. Der SessionSpecifier wird berücksichtigt und ein CacheBuster wird ggf. angehangen. Die zurückgegebene Url endent grantiert auf "&".
bool | [allowCaching] |
Gibt an, ob der Request potentiell aus dem Browsercache bedient werden darf. Wenn nicht, wird ein CacheBuster angehangen. (Standardwert: false) |
string | Eine auf "&" endende URL |
Informationsbubble in der Karte ausblenden
Gibt an, ob im MapControl die Kachel-Karte verfügbar und aktiv ist. Die Kachelkarte geht zwangsweise in den inaktiven Zustand, wenn die einfache Karte in einem geografischen Bezugssystem angezeigt wird, welches der Kachelkarte nicht bekannt gemacht worden ist. returns {bool}
Zeichnet eine Redlinegeometrie in die dynamische Karte
(refreshMap erforderlich)
string | geom |
Geometrie in der IWAN Textrepräsentation (wird z.B. auch so von der Shape Klasse geliefert |
int | symbolNumber |
Symbolnummer aus der am Server eingestellten Redline Symbolpalette |
string | [name] |
optionaler Name, um diese Geometrie unter diesem Namen anzulegen bzw. einer bereits so benannten Gruppe zuzuordnen (Standardwert: '') |
string | [mode] |
Verarbeitungsmodus, möglich ist ADD oder REPLACE (Standardwert: 'ADD') |
string | [rop2Code] |
Methode, wie die Redlinegeometrie mit dem Kartenbild bei der Darstellung kombiniert werden soll (mögliche Werte siehe MSDN) (Standardwert: "R2_COPYPEN") |
Öffnet die Übersichtskarte
(siehe auch closeOverviewMap)
bool | suppressAnimation |
Die Animation des Vorganges wird unterbunden wenn true übergeben wird. |
Karte an übergebener Koordinate zentrieren
(refreshMap erforderlich)
double | x |
X-Wert (geografisch) |
double | y |
Y-Wert (geografisch) |
Kartenbild neu vom Mapserver anfordern. Dabei werden alle seit der letzen Kartenaktualisierung im Befehls-Queue aufgelaufenen Aktionen ausgeführt.
Kartengröße (neu) festlegen
object | size |
neue Kartengröße mit |
||||||
|
Berechnet aus einer Bildschirmkoordinate die geografische Koordinate im aktuellen Kartenbild. Die linke obere Bildecke ist dabei die Koordinate (0,0).
int | x |
X-Wert |
int | y |
Y-Wert |
useLastFixedExtent |
object | Objekt mit {x, y} (geografisch) |
Filtert eine oder mehrere Ebenen mit Hilfe einer Bedingung im ISQL Format. Zum Aufheben eine Filters muss eine leere Zeichenfolge als ISQL Bedingung angegeben werden.
//einfachster Fall glbMap.setFilter({L245:"id = 12"}, false); //Filter und eigene Callback-Funktion glbMap.setFilter({L245:"id = 12"}, false, setFilterCallback); function setFilterCallback(result) //Callback-Funktion { if(result.error) //allgemeiner Fehler (z.B. Mapserver nicht erreichbar) alert(result.error.Message); else { for(var i=0; i<result.length; i++) { var result=result[i]; // hat: layerName, hasFilter, error if(result.error) //ebenenspezifischer Fehler (z.B. falsche Spalte, Ebene nicht geladen o.a.) alert("Fehler bei Ebene "+result.layerName+": "+result.error); } glbMap.refreshMap(); } }
object | layerFilter |
Objekt mit Ebenenname als Schlüssel und ISQL Ausdruck als Wert |
bool | clearSel |
Gibt an, ob eine evtl. bestehende Selektionsmarkierung (egal welcher Ebene) gelöscht werden soll |
function | [callback] |
Eine Callback-Funktion mit der Signatur function(result), die nach Ausführen des Filters aufgerufen wird (standardmäßig wird die Karte aktualisiert bzw. per alert eine Fehlermeldung ausgegeben). Die fn bekommt als Argument ein Array mit den Ergebnissen pro Layer [{layerName:"L12", hasFilter:true, error:null}]. Bei allgemeinen Fehlern bekommt das Array noch eine Eigenschaft error, auf die als erstes getestet werden sollte. |
Stellt den Bild-Typ der Karte auf den angeforderten Wert
(refreshMap erforderlich)
string | imageType |
mögliche Werte: Ecw|Emf|Gif|Jpg|Png|Png8|Png24|Png32 |
Setzt den Bildtyp der Karte wieder auf den Wert, wie er beim Initialisieren des Mapcontrols (serverseitig) eingestellt war. Dabei wird auch beachtet, wenn für den IE6 wegen der Transparenzprobleme ein alternativer Bildtyp eingestellt wurde.
Ebenenliste neu setzen. Die Ebenen sind mit "|" zu trennen ("L1|L2|L3|Grenzen|L4"). Das Schlüsselwort "ALL" kann
an Stelle der Liste verwendet werden, um alle Ebenen des Projektes anzuzeigen. Die Reihenfolge der Ebenen
in der Liste ist gleichzeitig die Zeichenreihenfolge bei der Bilderstellung.
(refreshMap erforderlich)
string | layerList |
"|" - getrennte Liste mit Ebenennamen oder "ALL" |
Setzt die Karte auf den übergebenen Maßstab.
Das erreichen dieses Maßstabes ist allerdings nicht garantiert. Maßstabsbeschränkung
und/oder die Kombination mit einer Tile Karte können dazu führen, dass nur der
nächstmögliche Maßstab erreicht wird.
(refreshMap erforderlich)
int | scale |
gewünschter Maßstab |
Setzt das geografische Bezugssystem für die Karte. Achtung - diese Aktion läuft asynchron! Ist die einfache
Karte aktiv, dann muss noch refreshMap
aufgerufen werden, aber auch, wenn nur die Kachelkarte aktiv ist, erfordert
die Transformation der Koordinaten einen Server-Roundtrip.
Nach erfolgreicher Umstellung, wird das Ereignis onMapSrsChanged
ausgelöst.
(refreshMap erforderlich)
int | epsgCode |
Codenummer der EPSG für das gewünschte Bezugssystem http://www.epsg.org/Geodetic.html |
Legt die Position der Kachelkarte gegenüber der "einfachen" Karte fest.
string | position |
mögliche Werte: "bottom" (ist Standard) oder "top" |
Setzt das aktive Kartenwerkzeug entsprechend des übergebenen Befehls.
Mögliche Befehle sind: Map.FullAuto, Map.Pan, Map.ZoomIn, Map.ZoomOut, Map.SimpleClick, Map.CustomSimpleClick, Map.Redline, Map.RedlineMoveVertex, Map.RedlineAddVertex, Map.Redline_DropVertex
string|object | args |
der Befehl als Zeichenkette oder ein Konfigurationsobjekt mit |
||||||||||||
|
string | Der bisher aktive Befehl. |
Informationsbubble anzeigen.
Wird eine vollständige Bubble genutzt, sollte auch die Schließen-Funktion implementiert werden
(x in der Ecke und Aufruf von glbMap.hideInfoDiv()).
config |
{object} Konfigurationsobjekt mit |
|||||||||||||
|
Selektieren und zoomen auf ein/mehrere Objekt(e) einer Ebene.
(refreshMap erforderlich)
glbMap.showObject("BUILDINGS", "str = 'Hauptstraße' AND hnr = 12", "ZoomAlways", 250);
string | layer |
Ebenenname |
string | iSqlWhere |
ISQL Filter Ausdruck (nur die Bedingungen des WHERE-Teiles); siehe http://www.webmapserver.de/isql |
string | [zoomBehavior] |
Zoom-Verhalten im Trefferfall: "ZoomAlways" (Standard), "NoZoom" [derzeit noch nicht impl.: "ZoomIfPartialyOutOfBounds", "ZoomIfFullyOutOfBounds"] (Standardwert: "ZoomAlways") |
double | [offset] |
Abstand beim Zoomen zum Kartenrand um das/die Objekt(e) herum; (Standardwert: 100) |
Transformiert eine Koordinate von einem Bezugssystem in ein anderes. Stehen mehrere Punkte zur Transformation an, dann sollte unbedingt die Methode glbMap.transformPoints benutzt werden.
double | x |
X-Wert der Eingangskoordinate |
double | y |
Y-Wert der Eingangskoordinate |
int | fromEpsgCode |
EPSG Code des Eingangsbezugssystems |
int | toEpsgCode |
EPSG Code des Zielbezugssystems |
function | callback |
callback-Funktion für die Rückgabe der transformierten Koordinate mit der Signatur function(result) und result={error:{Message:...}, x:..., y:...} |
Transformiert eine Liste von Koordinate von einem Bezugssystem in ein anderes. Stehen mehrere Punkte zur Transformation an, dann sollte unbedingt die Methode
glbMap.transformPoints([{x:1234, y:3456}, {x:1235, y:4567}], glbMap.currentSrs, 4326, function (res) { if(res.error) return alert(res.error.Message); else alert(res[0].x +" "+ res[0].y +" | "+res[1].x +" "+ res[1].y); } );
object[] | points |
beliebig tiefe Struktur ohne Zirkelbezüge (aus Arrays und Objekten) in der geschaut wird, ob x,y oder gx,gy gemeinsam vorkommen {x:...,y:...} oder {gx:...,gy:...}. Die erkannten Koordinaten werden dann inline transformiert. Es stört nicht, wenn noch andere Member neben x,y bzw. gx,gy vorhanden sind. |
int | fromEpsgCode |
EPSG Code des Eingangsbezugssystems |
int | toEpsgCode |
EPSG Code des Zielbezugssystems |
function | callback |
callback-Funktion zum entgegennehmen der Struktur mit den transformierten Koordinaten mit der Signatur function(result) res hat im Fehlerfall die Eigenschaft error mit der Eigenschaft Message. |
- Siehe auch:
- glbMap#transformPoints benutzt werden.
Kartenausschnitt festlegen
(refreshMap erforderlich)
double | xMin |
X-Wert linke untere Kordinate (geografisch) |
double | yMin |
Y-Wert linke untere Kordinate (geografisch) |
double | xMax |
X-Wert rechte obere Kordinate (geografisch) |
double | yMax |
Y-Wert rechte obere Kordinate (geografisch) |
Halbiert den aktuellen Kartenmaßstab
Maßstab verdoppeln und Karte an übergebener Koordinate zentrieren
(refreshMap erforderlich)
double | x |
X-Wert (geografisch) |
double | y |
Y-Wert (geografisch) |
Verdoppelt den aktuellen Kartenmaßstab
Kartenausschnitt auf die Standardausdehnung zurücksetzen. Diese wird serverseitig beim MapControl
durch DefaultExtent oder DefaultExtentLayer festgelegt. Wurde keine dieser Angaben getroffen, wird auf die Ausdehnung aller momentan sichtbaren Ebenen gezoomt,
falls eine dynamische Karte zur Verfügung steht. Ist nur eine Tile Karte verfügbar/aktiv wird mittig auf die Stufe 0 gezoomt.
(refreshMap erforderlich)
Kartenausschnitt auf Ausdehnung der übergebenen Ebenen setzen
(refreshMap erforderlich)
string | layerList |
"|" - getrennte Liste mit Ebenennamen oder "ALL" |
Zoom auf eine Koordinate. Auf Wunsch kann die Position mit einem Punkt des Shape Objektes markiert werden.
(refreshMap erforderlich)
double | x |
X-Wert (geografisch) |
double | y |
Y-Wert (geografisch) |
double | [offset] |
Abstand von der Koordinate zum Kartenrand (Standardwert: 1000) |
bool | [showMarker] |
Koordinate markieren (Standardwert: false) |
Wird ausgelöst, nachdem das client-seitige Map-Control vollständig initialisiert wurde.
Alle Befehle zur Konfiguration des Startkartenbildes sind gesetzt. Die abschließende Anforderung der Startkarte
steht allerdings noch aus, so dass weitere Anpassungen an dieser Stelle noch möglich sind.
object | eventArgs |
Referenz auf glbMap |
Wird ausgelöst, nachdem das Map-Control clientseitig vollständig für Interaktionen zur Verfügung steht.
Dies ist der Fall, nachdem das erste Kartenbild vollständig geladen wurde.
object | eventArgs |
Referenz auf glbMap |
Wird vor dem Ereignis "onMapSimpleClick" ausgelöst, wenn im Modus MOUSACTION oder mit aktivem Werkzeug "Map.SimpleClick" oder "Map.CustomSimpleClick" in die Karte geklickt wird. Im eventArgs-Objekt kann suppressSimpleClickEvent gesetzt werden, um das Auslösen von "onMapSimpleClick" zu unterbinden.
object | eventArgs |
Info-Objekt mit |
||||||||||||||||||||||||||||||
|
Wird ausgelöst, wenn ein Fehler bei der Kartenerstellung aufgetreten ist. Die automatische Anzeige der Fehlernachricht kann durch Setzen der Eigenschaft handled im eventArgs Objekt unterbunden werden.
error | eventArgs |
Fehlerobjekt mit |
|||||||||
|
Wird ausgelöst, nachdem sich der angezeigte Kartenausschnitt geändert hat.
(Hinweis: Zugriff auf den neuen Ausschnitt erfolgt mit glbMap.extent)
object | eventArgs |
Referenz auf glbMap |
object | eventArgs |
Info-Objekt mit |
|||||||||||||||
|
Wird ausgelöst, nachdem das Kartenbild der "einfachen" Karte aktualisiert wurde. Im Fehlerfall (Mapserverfehler) wird dieses Event nicht ausgelöst!
object | eventArgs |
Referenz auf glbMap |
object | eventArgs |
Ereignis-Objekt mit |
||||||||||||||||||||||||
|
Wird ausgelöst, nachdem ein Request an den Mapserver abgeschlossen ist, unabhängig davon, ob der Request fehlerfrei ausgeführt wurde oder nicht.
Mit glbMap.lastMapServerError kann geprüft werden, ob ein Fehler vorliegt oder nicht.
object | eventArgs |
Referenz auf glbMap |
Wird ausgelöst, nachdem sich der angezeigte Kartenmaßstab geändert hat.
int | currentMapScale |
neuer Kartenmaßstab |
Wird ausgelöst, wenn die Kartenparameter nach Sitzungsablauf auf dem Server aus den Wiederherstellungsinformationen wiederhergestellt wurden. Dieses Ereignis kann benutzt werden, um weitergehende Wiederherstellungsaktionen auszuführen, etwa das Laden von UserLayern.
object | eventArgs |
Referenz auf glbMap |
Wird ausgelöst, wenn im Modus MOUSACTION oder mit aktivem Werkzeug "Map.SimpleClick" in die Karte geklickt wird.
object | eventArgs |
Info-Objekt mit |
|||||||||||||||||||||||||||
|
object | eventArgs |
Info-Objekt mit |
||||||
|
Wird ausgelöst, nachdem das Werkzeug für die Interaktion mit der Karte geändert wurde. Siehe auch glbMap.setTool
int | eventArgs |
Event-Args Objekt mit |
|||||||||
|