2. Benutzung

2.1. Allgemeine Form der Abfrage URL

Ü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.

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

ParameterBeschreibungZwingend
reqidimage1Ja
randZufallszahlNein
userGeoShop BenutzerJa
passwordGeoShop Benutzer PasswortJa
p11.Koordinate in der Form <Ost-Wert>/<Nord-Wert>Ja ( ausser bei fit)
p22.Koordinate in der Form <Ost-Wert>/<Nord-Wert>Ja ( ausser bei fit)
resgewünschte Auflösung in Pixel der GIF-Datei in der Form <Breite>x<Höhe>Ja
viewView, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendetNein
layersListe 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_formatAusgabeformat. Mögliche Werte sind: gif, jpg, png, png8, tiff, geotiff. Default-Wert: gifNein
jpg_qualityQualitä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
trafoinfoTransformations 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
moveVerschiebt 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
fitBerechnet 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. P2sind bei der Angabe von fit bedeutungslos.

Nein
no_annotationsUnterdrückt die Beschriftungen am Rand des Bildes (z.B. Copyright).Nein
background_colorDefiniert 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
meterZeichnet 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
dpi

Angabe der DPI (Dots per Inch) für TIFF oder GEOTIFF (z.B. 300). Der Parameter kann nur zusammen mit image_format=tiff oder image_format=geotiff verwendet werden.

Nein
geoshop_idsDefiniert kommasepariert GeoShop ID's. Wenn die Objekte mit diesen ID's im Bereich des Bildes liegen, werden diese highlighted.Nein
scaleMassstab. Wird für die korrekte Darstellung in Zusammenhang mit den GeoShop-Viewparametern min_scale / max_scale benötigt.Nein
highlight_colorDefiniert die Farbe zur Hervorhebung der Objekte (geoshop_ids). Mögliche Werte für highlight_color sind:
<R,G,B,A>

Highlight-Farbe als RGBA-Integer-Werte. Beispiel highlight_color=255,0,255,0.5 .

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&geoshop_ids=74077009&highlight_color=255,0,255,0.5

2.3. Erzeugung von GIF, JPEG oder PNG Bildern über eine Suchabfrage (Query)

ParameterBeschreibungZwingend
reqidimage2Ja
randZufallszahlNein
userGeoShop BenutzerJa
passwordGeoShop Benutzer PasswortJa
queryVordefinierte 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,1002Ja
zoomareaGewünschte Fläche für Zoom ( nur bei Punktqueries sinnvoll)Nein
p11.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
p22.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
resgewünschte Auflösung in Pixel der GIF-Datei in der Form <Breite>x<Höhe>Ja
viewView, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendetNein
layersListe 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_formatAusgabeformat. Mögliche Werte sind: gif, jpg, png, tiff, geotiff. Default-Wert: gifNein
jpg_qualityQualitä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
trafoinfoTransformations 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_annotionsUnterdrückt die Beschriftungen am Rand des Bildes (z.B. Copyright).Nein
background_colorDefiniert 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
meterZeichnet 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
dpi

Angabe der DPI (Dots per Inch) für TIFF oder GEOTIFF (z.B. 300). Der Parameter kann nur zusammen mit image_format=tiff oder image_format=geotiff verwendet werden.

Nein
geoshop_idsDefiniert 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
scaleMassstab. 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:

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

ParameterBeschreibungZwingend
reqidlink1Ja
randZufallszahlNein
userGeoShop BenutzerJa
passwordGeoShop Benutzer PasswortJa
p11.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
p22.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
viewView, der angezeigt werden soll. Falls nichts angegeben wird, wird der Default-View des Benutzers verwendetNein
layersListe 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
pPunkt, an dem die URL abgefragt werden soll in der Form <Ost-Wert/Nord-Wert>Ja
oclassObjektklassen, die abgefragt werden soll. Mehrere Klassen werden kommasepariert. * frür alle Klassen.Ja
allAlle 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. 300). Der Parameter kann nur zusammen mit image_format=tiff oder image_format=geotiff verwendet werden.

Nein
geoshop_idsDefiniert 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
scaleMassstab. 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:

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&geoshop_ids

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="" .