Testseite für externe Aufrufe (JSON) |
  
|
Testseite für externe Aufrufe (JSON) |
|
Um einen Eindruck zu bekommen, wie man eine JSON Bildvorschau in einer Webseite nutzt und um eine Testmöglichkeit für die Aufrufe zu haben, stellt SynerGIS die Datei 'testextcall.htm' zur Verfügung. Rufen Sie diese entweder mit http://<WebOffice web application>/testextcall.htm oder über die WebOffice 10 R3 Administrationsseite im Reiter Applikation - Testseite für externe Aufrufe - auf.
(Für weitere Information siehe Kapitel Service API, Testseite für externe Aufrufe)
Diese Testseite gliedert sich in mehrere Bereiche:
•Beispielhafte Abfragen (Sample Requests)
•Formular zum einfachen Erstellen von Requests (Generated request form)
•Request und Responses
•Parameter (Supported parameters)
Testseite - testextcall.htm
Nachfolgende Beispiele zeigen einen beispielhaften Aufruf basierend auf dem WebOffice_SampleProject.
Beispiel A: externe Suche ausführen
Vorgehensweise:
1.Auswählen der beispielhaften request-Vorlage "Query/filter combination"
2.Die entsprechenden Parameter mit den projektspezifischen Feldern befüllen (project, format, query, keyname, keeyvalue, ...)
3.Klick des Buttons "Call to WebOffice using POST" um die Abfrage auszuführen.
4.Um ein Kartenbild zu erhalten klicken Sie auf die "Click to show map image".
Konfiguration einer Query
Der vollständige Request für Beispiel A lautet:
synservice?project=WebOffice_SampleProject&format=json&query=COUNTRY&keyname=CNTRY_NAME&keyvalue=AUSTRIA
Die Response auf den vorangegangenen Request lautet:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_20120515/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120516_165540_372_53.jpg",
"x":4570333.84795,"y":2744950.30755,"scale":3698238.472425819,"width":640,"height":400,"upp":978.4942194843752},"FEATURES":{"COORDS":[{"x":382,"y":216}]},
"response_id":"86461db8-f952-49a2-92d5-ec5673652238"}
Folgende Parameter sind im Response enthalten
•eine URL zum generierten Kartenbild
•X und Y- Koordinaten zum Kartenmittelpunkt
•Maßstab des Kartenbild
•Höhe und Breite des Kartenbild
Beispiel B: externe Suche mit Parametern "&returnkey" und "&geometry"
Die Parameter "&returnkey" und "&geometry" werden unterstützt, müssen aber eigenständig hinzugefügt ('Additional parameters') werden.
I. "&returnkey"
Beispiel für einen Request mit "&returnkey":
query=COUNTRY&keyname=CNTRY_NAME&keyvalue=Austria&returnkey=LONG_NAME
Daraus ergibt sich folgende Response:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_20120515/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120515_172844_806_8c.jpg",
"x":4570333.84795,"y":2744950.30755,"scale":3698238.472425819,"width":640,"height":400,"upp":978.4942194843752},"FEATURES":{"keyname":["CNTRY_NAME"],
"COORDS":[{"x":382,"y":216,"keyvalue":["Austria"]}]},"response_id":"f4b7408b-85d9-478f-b227-3aeee6929ff2"}
II. "&geometry"
Wenn Sie eine Suche/Selektion nicht attributiv sondern über Koordinaten ausführen möchten, dann verwenden Sie im Request den Parameter '&geometry'' und fügen diesen anstelle der Parameter "&keyvalue" und "&keyname" ein.
Daraus ergibt sich folgende Response:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_20120515/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120515_174159_228_ac.jpg","x":4820637.819250001,
"y":2807579.80765,"scale":1256055.7877890104,"width":200,"height":200,"upp":332.33209185000516},"FEATURES":{"keyname":["CITY_NAME"],"COORDS":[{"x":191,"y":100,"keyvalue":["Bratislava"]},
{"x":9,"y":100,"keyvalue":["Vienna"]}]},"response_id":"ac4cb877-f7fd-4380-84d9-f0b2571a8af7"}
Parameter "&returnkey" und "&geometry"
Beispiel C: Metainformationen anzeigen lassen
Der Parameter metainfo=true ermöglicht die Ausgabe von Metainfos (bestimmte Konfigurationswerte) von Tools. (Dieser Parameter muss aber eigenständig hinzugefügt ['Additional parameters'] werden.)
Hinweis: Aktuell wird nur die Metainfo für das Standortbestimmungstool ausgegeben, welches auch im WebOffice 10 R3 Projekt konfiguriert sein muss. Ist diesen Tool nicht implementiert, dann werden auch keine Infos ausgegeben.
Request mit Parameter '&metainfo=true':
synservice?project=WebOffice_SampleProject&width=400&height=300&format=json&metainfo=true
Daraus ergibt sich folgende Response:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_SP1_latestBuild/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120830_120351_742_5a.jpg","x":4437585.5,"y":2745738,"scale":9204617.811200581,"width":400,"height":300,"upp":2435.393333333334},"METAINFO":{"tool_geolocation__init_scale":"1000"},"response_id":"ae0d2f2b-b491-4f0b-b52a-4670081a27bc"}