Parametrisierter Aufruf des GeoViewers

Transkript

1 Geoinformation Parametrisierter Aufruf des GeoViewers Anleitung Seite 1/15

2 Inhaltsverzeichnis 1. Einführung Parametrisierter Aufruf Aktuelle Ansicht als parametrisierten Aufruf speichern Parameter und Werte Parameter pin Parameter text Parameter search Parameter srhl Aufrufmöglichkeiten Objekt Strasse Adresse Parzelle Koordinate Kartenausschnitt Parameter cps Parameter extent Kartenthema, Layer und Hintergrundkarte Kartenthema Layer Hintergrundkarte Parameter-Kombinationen Fortgeschrittene Möglichkeiten GeoViewer als iframe in Webseite einbetten Syntax Beispiele Seite 2/15

3 1. Einführung 1.1 Parametrisierter Aufruf Wenn der GeoViewer mit der URL aufgerufen wird, wird standardmässig der Stadtplan in der Innerstadt gezeigt. Es ist jedoch auch möglich, beim Aufruf in der URL Parameter mitzugeben, um beispielsweise einen anderen Ausschnitt, eine andere Hintergrundkarte oder eine spezifische Adresse anzuzeigen. In diesem Dokument wird erläutert, welche Parameter verfügbar sind und wie diese verwendet werden können, um den GeoViewer spezifisch aufzurufen. Für den Schnelleinstieg sei Kapitel 2 nahegelegt, in dem alle Aufrufmöglichkeiten mit Angabe der Syntax und eines Beispiels aufgeführt sind. 1.2 Aktuelle Ansicht als parametrisierten Aufruf speichern Es ist möglich, die aktuelle Kartenansicht als parametrisierten Aufruf zu speichern. Vorgehen: 1. Mit der linken Maustaste in das Feld mit dem Link klicken (s. Abbildung 1) 2. CTRL+C betätigen 3. mit CTRL+V z.b. in einem einfügen Folgendes ist beispielsweise die URL zur Abbildung 1: odefault&layers=parzplan_vektor_grau_2000,baumkataster Abbildung 1: Feld mit dem Link der aktuellen Kartenansicht (rot markiert). 1.3 Parameter und Werte Parameter sind spezielle Wörter, die hinter der Stamm-URL angefügt werden. Mehrere Parameter werden voneinander durch das kaufmännische Und-Zeichen & getrennt. Hinter jedem Parameter folgt ein Gleich-Zeichen = und ein oder mehrere, durch Komma getrennte Werte. Seite 3/15

4 Beispiel für einen parametrisierten GeoViewer-Aufruf: layers=stadtplan_farb_teb_osm_5000 Die verfügbaren Parameter sind in Tabelle 1 aufgeführt, jeweils mit Syntax und Beispielen der möglichen Werte. Parameter Werte Syntax Beispiele instance <Instanzname> geoportal (default) richtplan mashup language <de en fr > de (default) en fr theme <Theme-ID> 1 (default Stadtplan) cps <Rechtskoordinate>,<Hochkoordinate>, , ,10000 <Massstab> extent <Rechtskoordinate>,<Hochkoordinate>, , , , <Rechtskoordinate>,<Hochkoordinate> layers <Layername 1>,<Layername 2>,, <Layername n> stadtplan_grau_osm_10000,lesp Default-Hintergrundkarte: layerobj_stadtplan_farb_teb_osm_10000 themelayers <Layername 1>,<Layername 2>,, poi_gastro_event,poi_gastro_restaurant <Layername n> search <Stichwort 1>,<Stichwort 2>,, strasse,exact,münsterplatz <Stichwort n> srhl <Layername> <Objekt ID> srhl=layerobj_baumfael pin [<Rechtskoordinate>,<Hochkoordinate> on] <Farbe[blue green grey red white yellow ]> Falls keine Koordinaten angegeben werden, wird der Pin gemäss default extent oder parameter cps dargestellt. text <Rechtskoordinate>,<Hochkoordinate> <eigener Text> <Farbe [hexadezimal ohne #]> <Hintergrundfarbe [transparent] [hexadezimal ohne #]> <Schriftgrösse in Pixel> <offsetx in Pixel> <offsety in Pixel> pin= , green Falls keine Koordinaten angegeben werden, wird der Text gemäss default extent oder parameter cps dargestellt. das ist ein beispiel text ff0000 ffffff für Verlinkung (kein Direktaufruf in Browser) sollte der Text encoded werden: das ist ein beispiel text -> das%20ist%20ein%20beispiel%20text Tabelle 1: Parameter und Werte (Syntax und Beispiele). Schwarzer Text, 12px, auf weissem Hintergrund (default) Seite 4/15

5 1.4 Parameter pin Soll beim GeoViewer-Aufruf eine bestimmte Koordinate mit einem Pin markiert werden, steht der Parameter pin zur Verfügung. Folgende Pin-Farben können verwendet werden: white, red, blue, green, yellow, grey. Beispiele &pin=on &pin=red &pin= , &pin= , red Tabelle 2: Aufrufbeispiele für den Parameter pin Erklärung Weisser, zentrierter Pin Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter, zentrierter Pin Koordinaten über default extent oder Parameter cps, extent, srhl oder search weisser pin an lv03 roter pin an lv Parameter text Soll beim GeoViewer-Aufruf ein eigenes Textfeld auf der Karte erscheinen, steht der Parameter text zur Verfügung. Die Farbe des Textes und des Hintergrundfeldes werden in hexadezimal angegeben ohne # (z.b. ff0000 für rot oder für schwarz). Für die Verlinkung (d.h. kein Direktaufruf im Browser) sollte der Text encoded werden (z.b. das%20ist%20ein%20beispiel%20text) Beispiele &text=hallo &text=hallo ff &text=hallo ff0000 transparent &text=hallo ff0000 transparent 20 &text=hallo ff0000 ffffff &text= , hallo ff Tabelle 3: Aufrufbeispiele für den Parameter text Erklärung Schwarzer, zentrierter Text 12px auf weissem Hintergrund Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter, zentrierter Text 12px auf schwarzem Hintergrund Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter, zentrierter Text 12px auf transparentem (ohne) Hintergrund Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter, zentrierter Text 20px auf transparentem (ohne) Hintergrund Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter Text 20px auf weissem Hintergrund, mit einem X-Offset von -4px und Y-Offset von -2px Koordinaten über default extent oder Parameter cps, extent, srhl oder search Roter Text 12px auf schwarzem Hintergrund an den angegebenen lv03 Koordinaten mit einem X-Offset von -4px und Y-Offset von -2px 1.6 Parameter search Soll beim GeoViewer-Aufruf ein bestimmtes Objekt, z.b. eine Strasse, Adresse oder Parzelle angezeigt und mit einem Pin markiert werden, steht der Parameter search zur Verfügung (beim Aufruf wird eine Suche nach dem anzuzeigenden Objekt durchgeführt, daher der Name). Hinter dem Parameter search folgen Stichwörter, die das anzuzeigende Objekt beschreiben. Hierbei sind sogenannte Metatags wichtig, die den Objekttyp beschreiben (Strasse, Adresse oder Parzelle) und erzwingen, dass nur ein Objekt angezeigt werden soll ( exact ). Die zur Verfügung stehenden Metatags sind in Tabelle 44 beschrieben. Seite 5/15

6 Weitere Layer, auf welche gesucht werden kann, sind in der Tabelle 5 vermerkt. So kann zum Beispiel nach Mobility Standorten gesucht werden, indem hinter dem Parameter search die Stichworte mobility und riehen stehen. Es wird eine Liste aller Mobility Standorte in Riehen angezeigt. Beispiel für einen parametrisierten GeoViewer-Aufruf, der die Adresse Freie Strasse 59 anzeigen soll: 59,basel Beispiel für einen parametrisierten GeoViewer-Aufruf, der eine Liste von Mobility Standorten für die Gemeinde Riehen zurückgibt: Anmerkung: Strassennamen, die Leerzeichen enthalten, müssen mit Anführungszeichen versehen werden, z.b. freie strasse (s. oben genanntes Beispiel). Metatags strasse adresse parzellen strid_hausnr exact Zweck Suche nach Strassen (ohne Hausnummer) Suche nach Adressen (beinhaltet Hausnummer) Suche nach Parzellen Suche nach einer Adresse mittels Strassen-ID und Hausnummer Metatag, das erzwingt, dass die angegebenen Suchstichwörter exakt übernommen werden (z.b. wird Hausnummer 1 genau als 1 und nicht als Teil von 11 oder 111 interpretiert). Muss immer angegeben werden. Tabelle 4: Metatags, die mit dem Parameter search verwendet werden können. Layergruppen Entsorgung Freizeit Gastronomie Gesundheit & Soziales Hotels Kirchen & religiöse Gemein. Kultur & Unterhaltung Öffenltiche Einrichtungen & Einteilungen Schulen & Betreuung Sehenswürdikeiten Sport Velostadtplan Verkehr TNW Haltestelle Bilder Baumkataster Bohrkataster Naturobjekt Taxonobjekt Allmendbewilligung Suchfelder - Name - Subkategorie Beispiele: search=gasthof Rössli search=brillen, Fielmann search=ruine - Name der Haltestelle - Gemeinde - Kanton - Land - ID - Baumnummer - catnumber45 - ID - ID - ID Tabelle 5: Layer auf welche ebenfalls mittels Parameter search gesucht werden kann Seite 6/15

7 1.7 Parameter srhl Dieser Parameter (srhl =search result highlight) wird vom Geoviewer verwendet, wenn eine Suche über das Suchfeld ausgeführt wurde und ein eindeutiges Objekt angezeigt wird. Der Parameter srhl identifiziert das Suchobjekt eindeutig und setzt einen Pin auf diese Stelle. Beispiel für einen parametrisierten GeoViewer-Link, der einen Baum mittels Objekt-ID markiert: l=layerobj_baumfael Anmerkung: Die Obejkt-ID und der Layername muss gekannt werden, damit dieser Parameter verwendet werden kann. Seite 7/15

8 2. Aufrufmöglichkeiten 2.1 Objekt Strasse Für eine Strassensuche kann das Stichwort strasse und (1) der Strassenname und der Ort bzw. die Gemeinde, oder (2) das Stichwort strassenid und die Strassen-ID angegeben werden. Strassennamen, die Leerzeichen enthalten, müssen mit Anführungszeichen versehen werden (s. folgendes Beispiel). Die Strassensuche ist im gesamten Gebiet der Stadt- und Ortspläne möglich. (1) Aufruf mit Strassennamen: <Strassenname>,<Ort> "im hirshalm",riehen (2) Aufruf mit Strassen-ID: <Strassen-ID> Anmerkung: Nur Strassen innerhalb des Kantons enthalten eine Strassen-ID Adresse Für eine Adresssuche muss das Stichwort adresse, Strassenname, Hausnummer und wenn möglich der Ort angegeben werden. Strassennamen, die Leerzeichen enthalten, müssen mit Anführungszeichen versehen werden (s. oben genanntes Beispiel). Adresssuche ist im Kantonsgebiet möglich. <Strassenname>,<Hausnummer>,<Ort> münsterplatz,11,basel Parzelle Für eine Parzellensuche muss das Stichwort parzellen, die Parzellennummer und Sektion angegeben werden. <Parzellennummer>,<Sektion> ,5 Anmerkung: Parzellennummer immer vierstellig eingeben. Falls sie nicht vierstellig ist, vorne mit Nullen auffüllen, z.b Seite 8/15

9 2.1.4 Koordinate Für den Aufruf eines Objektes oder Ortes für welches die Koordinate bekannt ist, kann der Parameter pin verwendet werden. <Hochkoordinate> <Farbe> blue 2.2 Kartenausschnitt Um einen spezifischen Kartenausschnitt zu erhalten, kann entweder der Parameter cps oder extent verwendet werden. Beim Parameter cps wird die Koordinate des Mittelpunktes und ein Massstab angegeben, beim Parameter extent ein Kartenausschnitt mittels zweier Koordinatenpaare Parameter cps Syntax <Hochwert>,<Massstab> Beispiel ,2000 Anmerkung: Massstab ohne 1: angeben, z.b für 1: Parameter extent Syntax <Hochwert>,<Rechtswert>,<Hochwert> Beispiel , Kartenthema, Layer und Hintergrundkarte Kartenthema Jedes Kartenthema wird über eine bestimmte Zahl aufgerufen. Im folgenden Beispiel wird über die Zahl 84 das Thema Basler Strassennamen aufgerufen. Anmerkung: Die Themennummer kann am einfachsten über die im Abschnitt 1.2 beschriebene Methode herausgefunden werden Layer Jeder Layer besitzt einen speziellen Layernamen über welchen er parametrisiert aufgerufen werden kann. Es kann einerseits bestimmt werden, welche Layer in der Legende dargestellt werden (Parameter themelayers). Andererseits kann angegeben werden, welche Layer standardmässig eingeblendet werden sollen (Parameter layers). Im folgenden Beispiel werden ausgewählte Layer des Themas Stadtplan-Informationen aufgerufen und die Restaurants standardmässig eingeblendet. rnamen>&layers=<layernamen> Seite 9/15

10 restaurant,poi_hotels_apartment,poi_hotels_bedbreakfast,poi_hotels_hotel,poi_hotels_seminarz& layers=poi_gastro_restaurant Anmerkung: Die Layernamen können am einfachsten über die im Abschnitt beschriebene Methode herausgefunden werden Hintergrundkarte Als Hintergrundkarte stehen im Prinzip zwölf verschiedene Layer zur Verfügung, wobei sie massstabsabhängig in unterschiedlichen Versionen vorhanden sind (s. Tabelle 66). Die Hintergrundkarte wird über den entsprechenden Layernamen aufgerufen. Anmerkung: Wenn in Kombination mit Parameter cps gebraucht, wird derjenige Massstab der Hintergrundkarte verwendet, welcher unter dem Parameter cps angegeben wurde. Seite 10/15

11 Hintergrundkarte Layername Gültig für Massstäbe Parzellenplan farbig parzplan_vektor_farb_500 parzplan_vektor_farb_1000 1:500 1:1000 parzplan_vektor_farb_2000 1:2000 Parzellenplan grau parzplan_vektor_grau_500 parzplan_vektor_grau_1000 parzplan_vektor_grau_2000 1:500 1:1000 1:2000 Parzellenplan schwarz-weiss parzplan_vektor_sw_500 parzplan_vektor_sw_1000 1:500 1:1000 parzplan_vektor_sw_2000 1:2000 Stadtplan farbig stadtplan_farb_teb_osm_5000 1:5000 (default) stadtplan_farb_teb_osm_10000 stadtplan_farb_teb_osm_25000 stadtplan_farb_teb_osm_50000 stadtplan_farb_teb_osm_ : : : : Stadtplan grau stadtplan_grau_osm_5000 1:5000 stadtplan_grau_osm_10000 stadtplan_grau_osm_25000 stadtplan_grau_osm_50000 stadtplan_grau_osm_ : : : : Stadtplan schwarz-weiss stadtplan_sw_osm_5000 1:5000 Orthofoto 2008 orthofoto2008_osm_500 orthofoto2008_osm_1000 etc. Orthofoto 2010 Orthofoto 2012 April Orthofoto 2012 Juli Reliefschattierung Loeffelplan orthofoto2010_osm_500 orthofoto2010_osm_1000 etc. orthofoto2012_osm_500 orthofoto2012_osm_1000 etc. orthofoto2012_juli_osm_500 orthofoto2012_juli_osm_1000 etc. dom_osm_500 dom_osm_1000 dom_osm_2000 etc. loeffel_osm_500 loeffel_osm_1000 loeffel_osm_2000 etc. Tabelle 6: Die Layernamen der verfügbaren Hintergrundkarten mit Angabe der gültigen Massstäbe. Alle Massstäbe vorhanden: 1:500 1:1000 1:2000 1:5000 1: : : : Alle Massstäbe vorhanden Alle Massstäbe vorhanden Seite 11/15

12 2.4 Parameter-Kombinationen Beim parametrisierten GeoViewer-Aufruf können fast alle Parameter miteinander kombiniert werden. So kann bei allen Aufrufen die gewünschte Hintergrundkarte und Thema eingeblendet werden. Wenn ein Thema eingeblendet wird können jedoch keine Layer eines anderen Themas hinzugefügt werden. Parameter welche das Gleiche auf unterschiedliche Weise machen, können nicht kombiniert werden (z.b.: extent und cps sowie search und srhl ). Beispiele 1. Anzeige einer Parzellensuche kombiniert mit dem Orthofoto 2012 Juli als Hintergrundkarte, dem Thema Baumkataster und einem Textfeld: %20die%20Parzelle%2014 ff0000 transparent &theme=228&layers=orthofoto2012_osm_ Anzeige des Themas Basler Strassennamen an einem bestimmten Kartenausschnitt: 3. Anzeige des Themas Historische Kartenwerke an einem bestimmten Kartenausschnitt, kombiniert mit einem Pin und einem Textfeld: yers=citymap_up1905&pin=611519, blue&text=%22mein%20arbeitsplatz%22 Die Parameter text und pin können praktisch beliebig kombiniert werden. Wenn bei Pin und Text dieselben Koordinaten angegeben werden oder bei beiden keine, wird der Pin mit dem Text kombiniert. Seite 12/15

13 3. Fortgeschrittene Möglichkeiten 3.1 GeoViewer als iframe in Webseite einbetten Der GeoViewer kann als kleines Kärtchen (iframe oder Mashup ) in eine beliebige Webseite eingebettet werden. Folgende drei Versionen stehen zur Verfügung: mashup_simple Mit Zoombalken und Anzeige des Massstabs mashup_extended Mit Zoombalken, und Anzeige des Massstabs und der Koordinaten. mashup Mit Zoombalken, Anzeige des Massstabs und einer konfigurierbarer Legende Syntax Um das iframe in eine Webseite einzubetten, muss HTML-Code folgender Syntax implementiert werden: <iframe src='<link>' frameborder='no' scrolling='no' width='<breite>' height='<höhe>' style='border-width: 0px; border-style: solid; margin:0; padding:0;'> Ihr Browser erfüllt die notwendigen Mindestanforderungen für diese Applikation nicht. Bitte verwenden Sie Firefox, Safari, Chrome, oder Internet Explorer. </iframe> Seite 13/15

14 <Link>, <Breite> und <Höhe> können individuell angepasst werden: <link> <Breite>, <Höhe> Link zum GeoViewer mit beliebigen Parametern. Muss instance=mashup_simple, instance=mashup_extendet oder instance=mashup enthalten. Beispiele für Aufrufmöglichkeiten innerhalb des iframes siehe folgenden Abschnitt. Für weitere Link- Beispiele siehe Kapitel 2. Breite und Höhe des iframe-fensters in Anzahl Pixel Beispiele Bitte bei den Beispielen beachten, dass zwischen index.php? und instance= eigentlich kein Zeilenumbruch vorhanden sein darf, d.h. es muss folgendermassen aussehen: index.php?instance=. 1. Anzeige einer Adresse Anzeige der Adresse Münsterplatz 11 mit der Pinnadel im erweiterten iframe (instance=mashup_extended). Durch search= wird eine Suche nach der Adresse durchgeführt. <iframe src=' instance=mashup_extended&search=exact,adresse,münsterplatz,11,basel' frameborder='no' scrolling='no' width='430' height='212' style='border-width: 0px; border-style: solid; margin:0; padding:0;'> Ihr Browser erfüllt die notwendigen Mindestanforderungen für diese Applikation nicht. </iframe> Dieses Beispiel ist auch in folgender Testseite aufgeführt: 2. Anzeige bestimmter Koordinaten Anzeige der Koordinaten / im Massstab 1:25'000 im einfachen iframe (instance=mashup_simple): <iframe src=' instance=mashup_simple&cps= , ,25000' frameborder='no' scrolling='no' width='300' height='150' style='border-width: 0px; border-style: solid; margin:0; padding:0;'> Ihr Browser erfüllt die notwendigen Mindestanforderungen für diese Applikation nicht. </iframe> 3. Anzeigen bestimmter Layer in der Legende Anzeigen einzelner Layer des Themas Stadtplan-Informationen und dem Orthofoto Juli 2012 als Hintergrundkarte im iframe mit Legende (instance=mashup): Seite 14/15

15 <iframe src=' instance=mashup&language=de&nodefault&theme=1&themelayers=poi_gastro_event,poi _gastro_restaurant,poi_hotels_apartment,poi_hotels_bedbreakfast,poi_hotels_hot el,poi_hotels_seminarz&layers=orthofoto2012_juli_osm_10000,poi_gastro_event,po i_gastro_restaurant' frameborder='no' scrolling='no' width='300' height='150' style='border-width: 0px; border-style: solid; margin:0; padding:0;'> Ihr Browser erfüllt die notwendigen Mindestanforderungen für diese Applikation nicht. </iframe> Seite 15/15