2. Bedienung

2. Bedienung
Zurück

2.1. Allgemeine Form der Abfrage URL

Ueber URL Strings kann der aktuelle Datenbestand des GeoShop abgefragt werden. Momentan sind folgende Abfragen realisiert:

Erzeugen von GIF, JPEG oder PNG Bildern über Koordinaten.
Erzeugen von GIF, JPEG oder PNG Bildern über eine vordefinierte Abfrage ( analog dem <Suchen> Menü im GeoShop Client Applet).
Abfrage von Sachdaten ( analog der [i] Schaltfläche im GeoShop Client Applet).

Eine Abfrage URL hat folgende allgemeinde Form:

http://<geoshop-URL>/webclient?<query-string>

Der <query-string> ist für jede Abfrage individuell. Der Aufbau des <query-string> ist in den folgenden Abschnitten beschrieben.

2.2. Erzeugung von GIF, JPEG oder PNG Bildern über Koordinaten

Parameter	Beschreibung	Zwingend
`reqid`	`image1`	Ja
`rand`	Zufallszahl	Nein
`user`	GeoShop Benutzer	Ja
`password`	GeoShop Benutzer Passwort	Ja
`p1`	1.Koordinate in der Form <Ost-Wert>/<Nord-Wert>	Ja ( ausser bei fit)
`p2`	2.Koordinate in der Form <Ost-Wert>/<Nord-Wert>	Ja ( ausser bei fit)
`res`	gewünschte Auflösung in Pixel der GIF-Datei in der Form <Breite>x<Höhe>	Ja
`view`	View, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendet	Nein
`layers`	Liste der Layer, die angezeigt werden sollen in der Form <Layer1>,<Layer2>,...,<LayerN>. Falls nichts angegeben wird, werden alle Layer des gewählten Views verwendet.	Nein
`image_format`	Ausgabeformat. Mögliche Werte sind: `gif`, `jpg`, `png`, `tiff`, `geotiff`. Default-Wert: `gif`	Nein
`jpg_quality`	Qualität bei JPEG Ausgabe. Für die Qualität kann ein Wert zwischen 0.0 ( niedrigste Qualität) und 1.0 ( höchste Qualität) angegeben werden.	Nein
`trafoinfo`	Transformations Information generieren. Falls dieser Parameter existiert, wird anstelle einer Bilddatei eine HTML Datei der folgenden Form erzeugt: <html> <body> <img src="images/img2.png?x1=675850.0&y1=245435.0&x2=675924.0&y2=245506.0" /> </body> </html> Aus dem Query String des <img> Tag kann man die linke untere Koordinate ( x1/y1) und die rechte obere Koordinate ( x2/y2) des generierten Bildes bestimmen.	Nein
`move`	Verschiebt den Ausschnitt ausgehend vom angegebenen Ausschnitt p1/p2 in die angegebene Richtung. Die Koordinaten des verschobenen Ausschnittes können mit `trafoinfo` abgefragt werden. Mögliche Werte für `move` sind: w Ausschnitt nach Westen verschieben e Ausschnitt nach Osten verschieben n Ausschnitt nach Norden verschieben s Ausschnitt nach Süden verschieben nw Ausschnitt nach Nord/West verschieben ne Ausschnitt nach Nord/Ost verschieben sw Ausschnitt nach Süd/West verschieben se Ausschnitt nach Süd/Ost verschieben in Ausschnitt vergrössern ( Zoom In) out Ausschnitt verkleinern ( Zoom Out)	Nein
`fit`	Berechnet den Ausschnitt so, dass alle Objekte aus allen angegebenen Layern dargestellt werden. Die Liste der Layer muss in der Form <Layer1>,<Layer2>,...,<LayerN> angegeben werden. Falls nichts angegeben wird, werden alle Layer des gewählten Views für die Berechnung des Ausschnittes ausgewählt. Die Parameter `P1` bzw. `P2`sind bei der Angabe von `fit` bedeutungslos.	Nein
`no_annotions`	Unterdrückt die Beschriftungen am Rand des Bildes (z.B. Copyright).	Nein
`background_color`	Definiert die Background Farbe. Mögliche Werte für `background_color` sind: transparent Die Background Farbe soll transparent sein. Wird nur bei `image_format=gif` oder image_format=png unterstützt, weil nur diese Formate eine Transparenz kennen. <R,G,B> Background Farbe als RGB-Integer-Werte. Beispiel `background_color=100,100,100` .	Nein
`meter`	Zeichnet einen Meterstab in der angegebenen Bildecke (ul,ur,ll,lr). ul Oben Links (upper left) = Default. ur Oben Rechts (upper right). ll Links Unten (lower left). lr Rechts Unten (lower right). Der Parameter muss für die Werte ur,ll und lr zusammen mit `no_annotations` verwendet werden.	Nein

Beispiel für einen möglichen WebClient Aufruf:

http://www.infogrips.ch/servlet/redirector/demo/webclient?reqid=image1&rand=78793&user=test&password=test &p1=675776/245364&p2=675850/245435&res=400x400&image_format=png&move=ne&trafoinfo

2.3. Erzeugung von GIF, JPEG oder PNG Bildern über eine Abfrage

Parameter	Beschreibung	Zwingend
`reqid`	`image2`	Ja
`rand`	Zufallszahl	Nein
`user`	GeoShop Benutzer	Ja
`password`	GeoShop Benutzer Passwort	Ja
`query`	Vordefinierte Abfrage. Alle Parameter der Abfrage werden mit ihrem Namen übergeben, z.B. Nummer=1001. Bei Multiqueries ist es erlaubt, mehrere Werte pro Parameter als Kommaseparierte Liste anzugeben, z.B. Nummer=1001,1002	Ja
`zoomarea`	Gewünschte Fläche für Zoom ( nur bei Punktqueries sinnvoll)	Nein
`p1`	1.Koordinate in der Form <Ost-Wert>/<Nord-Wert>. Normalerweise wird der Ausschnitt direkt über die Abfrage bestimmt. Mit p1/p2 kann der automatisch bestimmte Ausschnitt übersteuert werden.	Nein
`p2`	2.Koordinate in der Form <Ost-Wert>/<Nord-Wert>. Normalerweise wird der Ausschnitt direkt über die Abfrage bestimmt. Mit p1/p2 kann der automatisch bestimmte Ausschnitt übersteuert werden.	Nein
`res`	gewünschte Auflösung in Pixel der GIF-Datei in der Form <Breite>x<Höhe>	Ja
`view`	View, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendet	Nein
`layers`	Liste der Layer, die angezeigt werden sollen in der Form <Layer1>,<Layer2>,...,<LayerN>. Falls nichts angegeben wird, werden alle Layer des gewählten Views verwendet.	Nein
`image_format`	Ausgabeformat. Mögliche Werte sind: `gif`, `jpg`, `png`, `tiff`, `geotiff`. Default-Wert: `gif`	Nein
`jpg_quality`	Qualität bei JPEG Ausgabe. Für die Qualität kann ein Wert zwischen 0.0 ( niedrigste Qualität) und 1.0 ( höchste Qualität) angegeben werden.	Nein
`trafoinfo`	Transformations Information generieren. Falls dieser Parameter existiert, wird anstelle einer Bilddatei eine HTML Datei der folgenden Form erzeugt: <html> <body> <img src="images/img3.gif?x1=675850.481&y1=245435.581&x2=675924.195&y2=245506.095" /> </body> </html> Aus dem Query String des <img> Tag kann man die linke untere Koordinate ( x1/y1) und die rechte obere Koordinate ( x2/y2) des generierten Bildes bestimmen.	Nein
`no_annotions`	Unterdrückt die Beschriftungen am Rand des Bildes (z.B. Copyright).	Nein
`background_color`	Definiert die Background Farbe. Mögliche Werte für `background_color` sind: transparent Die Background Farbe soll transparent sein. Wird nur bei `image_format=gif` oder image_format=png unterstützt, weil nur diese Formate eine Transparenz kennen. <R,G,B> Background Farbe als RGB-Integer-Werte. Beispiel `background_color=100,100,100` .	Nein
`meter`	Zeichnet einen Meterstab in der angegebenen Bildecke (ul,ur,ll,lr). ul Oben Links (upper left) = Default. ur Oben Rechts (upper right). ll Links Unten (lower left). lr Rechts Unten (lower right). Der Parameter muss für die Werte ur,ll und lr zusammen mit `no_annotations` verwendet werden.	Nein

Beispiel für einen möglichen WebClient Aufruf mit Abfrage:

http://www.infogrips.ch/servlet/redirector/demo/webclient?reqid=image2&rand=78793&user=test&password=test &query=parzelle&gemeinde=Demogemeinde&nummer=3145&res=400x400&trafoinfo

2.4. Abfrage von Sachdaten

Parameter	Beschreibung	Zwingend
`reqid`	`link1`	Ja
`rand`	Zufallszahl	Nein
`user`	GeoShop Benutzer	Ja
`password`	GeoShop Benutzer Passwort	Ja
`p1`	1.Koordinate in der Form <Ost-Wert>/<Nord-Wert>. Normalerweise wird der Ausschnitt direkt über die Abfrage bestimmt. Mit p1/p2 kann der automatisch bestimmte Ausschnitt übersteuert werden.	Ja
`p2`	2.Koordinate in der Form <Ost-Wert>/<Nord-Wert>. Normalerweise wird der Ausschnitt direkt über die Abfrage bestimmt. Mit p1/p2 kann der automatisch bestimmte Ausschnitt übersteuert werden.	Ja
`view`	View, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendet	Nein
`layers`	Liste der Layer, die angezeigt werden sollen in der Form <Layer1>,<Layer2>,...,<LayerN>. Falls nichts angegeben wird, werden alle Layer des gewählten Views verwendet.	Nein
`p`	Punkt, an dem die URL abgefragt werden soll in der Form <Ost-Wert/Nord-Wert>	Ja
`oclass`	Objektklassen, die abgefragt werden soll. Mehrere Klassen werden kommasepariert. * frür alle Klassen.	Ja
`all`	Alle Links sollen gelesen werden. Ohne `all` wird der erste Link gelesen.	Nein

Beispiel für einen möglichen WebClient Aufruf mittels Punkt und Objektklasse:

http://www.infogrips.ch/servlet/redirector/demo/webclient?reqid=link1&rand=78797&user=test&password=test &p1=675776/245364&p2=675850/245435&p=675776/245346&oclass=*&all

Als Resultat wird eine HTML Seite mit einem Frame erzeugt. Der Frame enthält das Resultat der Abfrage als URL Link.

<html>
<frameset cols="*,0">
<frame src="data/info.html?Objekttyp=Parzelle&Nummer=1614&Flaeche=1295.74">
</frameset>
</html>

Falls keine Daten gefunden wurden, ist der URL Link leer, d.h. src="" .

Zurück
GeoShop WebClient Benutzerhandbuch	Zum Anfang