Über 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.
| 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,
png8, 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
| 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 | Nein |
no_annotations | Unterdrückt die Beschriftungen am Rand des Bildes (z.B. Copyright). | Nein |
background_color | Definiert die Background Farbe. Mögliche Werte für
| Nein |
meter | Zeichnet einen Meterstab in der angegebenen Bildecke (ul,ur,ll,lr).
Der Parameter muss für die Werte ur,ll und
lr zusammen mit | Nein |
dpi | Angabe der DPI (Dots per Inch) für TIFF oder GEOTIFF
(z.B. | Nein |
geoshop_ids | Definiert kommasepariert GeoShop ID's. Wenn die Objekte mit diesen ID's im Bereich des Bildes liegen, werden diese highlighted. | Nein |
scale | Massstab. Wird für die korrekte Darstellung in Zusammenhang
mit den GeoShop-Viewparametern min_scale /
max_scale benötigt. | Nein |
highlight_color | Definiert die Farbe zur Hervorhebung der Objekte
(geoshop_ids). Mögliche Werte für
| Nein |
Beispiel für einen möglichen WebClient Aufruf:
| Parameter | Beschreibung | Zwingend |
reqid | image2 | Ja |
rand | Zufallszahl | Nein |
user | GeoShop Benutzer | Ja |
password | GeoShop Benutzer Passwort | Ja |
query | Vordefinierte Suchabfrage (Query). Alle Parameter der Suchabfrage 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 Suchabfrage 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 Suchabfrage 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
| Nein |
meter | Zeichnet einen Meterstab in der angegebenen Bildecke (ul,ur,ll,lr).
Der Parameter muss für die Werte ur,ll und
lr zusammen mit | Nein |
dpi | Angabe der DPI (Dots per Inch) für TIFF oder GEOTIFF
(z.B. | Nein |
geoshop_ids | Definiert ob die GeoShop ID's der gefundenen Objekte
kommasepariert mit geoshop_ids=<ids> in
der trafoinfo-Information zurückgegeben werden sollen. Wird nur
berücksichtigt wenn auch der Parameter
trafoinfo gesetzt ist. | Nein |
scale | Massstab. Wird für die korrekte Darstellung in Zusammenhang
mit den GeoShop-Viewparametern min_scale /
max_scale benötigt. | Nein |
Beispiel für einen möglichen WebClient Aufruf mit Suchabfrage:
| 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 |
dpi | Angabe der DPI (Dots per Inch) für TIFF oder GEOTIFF
(z.B. | Nein |
geoshop_ids | Definiert ob die GeoShop ID's als Attribut
geoshop_id=<id> zurückgegeben werden
soll. Wird nur berücksichtigt wenn auch der Parameter
all gesetzt ist. | Nein |
scale | Massstab. Wird bei der Abfrage von GeoShop-Views mit den
Parametern min_scale /
max_scale benötigt. | Nein |
Beispiel für einen möglichen WebClient Aufruf mittels Punkt und Objektklasse:
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&geoshop_id=74077011"> </frameset> </html>
Falls keine Daten gefunden wurden, ist der URL Link leer, d.h.
src="" .