Kartendarstellung |
  
|
Kartendarstellung |
|
Folgende Parameter steuern die Kartenanzeige. (Siehe Kapitel Anzeige eines dynamischen Kartenbildes für nähere Inforamtionen.)
•baseURL (obligatorisch): Basis-URL von WebOffice 10 R3, um das SynService Servlet anzusprechen.
Ist die WebOffice map widget default.jsp Seite über http://<servername>:<port>/<webapplication>/client_preview/SynServiceClient/default.jsp und das SynService Servlet über die URL http://<servername>:<port>/<webapplication>/synservice erreichbar, dann ergibt sich: baseURL=http://<servername>:<port>/<webapplication>.
•project (obligatorisch): Die Projektkennung eines WebOffice 10 R3 Projektes. Zum Beispiel für das 'WebOfficeSampleProject' wird project=WebOfficeSampleProject verwendet.
•width (obligatorisch): Breite des Kartenbildes in Pixel. Beispiel: Breite soll 600 Pixel sein, dann wird width=600 verwendet.
•height (obligatorisch): Höhe des Kartenbildes in Pixel. Beispiel: Höhe soll 400 Pixel sein, dann wird height=400 verwendet.
•x: X-Koordinate des Mittelpunktes des Kartenbildes in Karteneinheiten (map units). Dieser Parameter erziehlt nur dann das gewünschte Ergebnis, wenn auch der Parameter y definiert wird.
Beispiel: Der Mittelpunkt des Kartenbildes soll bei x-Koordinate 1083156.624 abgebildet werden, daraus ergibt sich der Parmeter x=1083156.624 .
Hinweis: Kommas müssen durch Punkte „.“ ersetzt werden.
•y: Y-Koordinate des Mittelpunktes des Kartenbildes in Karteneinheiten (map units). Dieser Parameter erziehlt nur dann das gewünschte Ergebnis, wenn auch der Parameter x definiert wird.
Beispiel: Der Mittelpunkt des Kartenbildes soll bei y-Koordinate 6024173.425 abgebildet werden, daraus ergibt sich der Parmeter y=6024173.425 .
Hinweis: Kommas müssen durch Punkte „.“ ersetzt werden.
•scale: Das Projekt soll in einem bestimmten Maßstab aufgerufen werden. (Achten Sie darauf, dass es hier zu Unterschieden kommt, wenn gekachelte Dienste verwendet werden, da diese Kacheln in bereits vordefinierten Maßstabsstufen vorhanden sind.) Beispiel: Das Kartenbild soll in einem Maßstab von 1000 dargestellt werden, daraus ergibt sich der Parameter scale=1000 .
•view: Das Projekt soll in einer bestimmten Kartenansicht dargestellt werden. Die gewünschte Kartenansicht muss bereits im WebOffice 10 R3 Projekt konfiguriert sein. (Siehe dazu Kartenansichten.) Die Kennung für externe Aufrufe, welche in WebOffice author vergeben wurde, bildet den Wert für diesen Parameter. Beispiel: Die Kartenansicht 'OSM' wird durch view=OSM aufgerufen.
•map_adv: Der Parameter map_adv=true gibt generelle Auskunft über die Kacheln (tile URL, offset, Breite, Höhe, etc.)
•mapmargin: Werden gekachelte Kartendienste verwendet, dann definiert der Parameter mapmargin die Anzahl der Kacheln, die im Bereich des sichtbaren Kartenbereichs geladen werden. Dies ist dann sinnvoll, wenn User oft und viel den Kartenausschnitt verschieben (pannen). Der Default-Wert ist 1. Wenn der User des Öfteren weiße/leere Kartenbereiche während des panning sieht, dann kann es sinnvoll sein den Parameterwert zu erhöhen auf z.B. mapmargin=2 .
Hinweis: Wenn WebOffice map widget alleine unter Verwendung des default.jsp angezeigt wird, ist es möglich die Kachelgrenzen durch Drücken von "c" anzuzeigen. Kacheln sind blau dargestellt, wenn sie innerhalb des aktuellen Kartenausschnitts liegen, andere vorgerenderte Kacheln (definiert durch mapmargin) werden orange dargestellt.
•maptransparency: Mit diesem Parameter kann bestimmt werden, ob die zuletzt sichtbare Karte bei neuerlichem Laden mit einer Transparenz versehen wird. Hier können die Werte zwischen 0 (komplett sichtbar) und 1 (komplett unsichtbar) eingegeben werden. Ein Wert von 0.4 bedeutet somit 40% transparent. Bei rein deckenden Karten ist keine Transparenz nötig. Wird dieser Parameter nicht angegeben, wird 0 (deckend) angenommen.
Hinweise: Wird mit transparenten Kartendiensten gearbeitet, sollte man den Parameter maptransparency=1 verwenden, damit es bei der Bilddarstellung zu keinen Problemen (Artefakte) kommt.
•osm_timeout_mw: Der Parameter osm_timeout_mw definiert die Zeitspanne, innerhalb jener die Kacheln geladen werden können, bevor diese über eine andere Subdomain von OpenStreetMap geladen werden. Da es 3 Subdomains gibt, wird dieser Ablauf auch maximal 3 Mal wiederholt und kann über den Parameter in Millisekunden angegeben werden. Wird dieser Parameter nicht übergeben, dann wird dieser Wert mit 3333 Millisekunden angenommen. Damit dieser Mechanismus wirklich zu einem Zeitvorteil führen soll, sollte man diesen Wert weder zu hoch (die Dauer bis eine neue Subdomain aufgerufen wird ist dann zu lange) noch zu niedrig ansetzen. Wenn Sie z.B. 1 Sekunde angeben, dann können längere Wartezeiten beim Kachelaufbau deutlich reduziert werden.
Hinweis: Dieser Parameter ist nur bei der Verwendung von OSM-Kacheln relevant.
•geo_bookmark: Der Parameter geo_bookmark definiert eine Art Lesezeichen, um ein Projekt in einem bestimmten, räumlichen Ausschnitt abzurufen. Dieses Geo-Bookmark muss bereits in der Projektkonfiguration enthalten sein (Siehe dazu Geo-Bookmark .) Die Kennung für externe Aufrufe, welche in WebOffice author vergeben wurde, bildet den Wert für diesen Parameter. Beispiel: Das Geo-Bookmark Vienna, mit der der externen Kennung für externe Aufrufe 'VIE' wird mit geo_bookmark=VIE aufgerufen.
•exclude_north_and_scale: Durch die Angabe des Parameters &exclude_north_and_scale=true wird nur das Kartenbild angezeigt. Der Nordpfeil, die Maßstabsleiste und das Copyright werden durch diesen Parameter in weiterer Folge unterdrückt.