Dieser Request ermöglicht eine Adresssuche, bei der eine Adresse geokodiert und dargestellt wird. Die gefundene Adresse wird dabei in der Mitte der Karte dargestellt. (Siehe dazu 'Geolocators' für weitere Informationen)
Hinweis:
Die Adresssuche mittels Geolocator ist der 'Suche/Abfrage auf einen Layer' sehr ähnlich, unterscheidet sich aber dadurch, dass der Parameter keyfield nicht angegeben werden muss. Außerdem werden in der Response x/y Koordinaten der Suchergebnisse zurückgegeben.
Folgende Parameter sind für den Request notwendig:
•query (obligatorisch): Der Parameter query definiert die externe Kennung der Geolocator-Suche.
•keyvalue (obligatorisch): Wenn nach der Adresse ‘Altgasse 1, Bregenz’ gesucht werden soll, dann lautet der Parameter keyvalue=altgasse,%201,%20bregenz .
Möglicher Request:
http://w-vpc-kr-w7-e:8080/WO_10R3_SP2_latestBuild/client_mapwidget/default.jsp?baseURL=http://w-vpc-kr-w7-e:8080/WO_10R3_SP2_latestBuild&project=WebOffice_SampleProject_Doku&width=600&height=400&view=OSM&mapmargin=1&combined_req=true&maptransparency=1.0&query=Geolocator&keyvalue=Technologiestraße 10, Wien
•returnkey
Wenn in der Ergebnisfeldliste einer Geolocator-Suche diverse Ergebnisfelder konfiguriert sind, dann können diese Felder als Werte für den Parameter returnkey verwendet werden.

Geolocator - Ergebnisfelder
Folgende beiden Werte liefern ein sinnvolles Ergebnis:
I.returnkey=score
Ein score von 100 bedeutet, dass die gesuchte Adresse ganz genau gefunden wurde. Wenn eine Adresse also nicht genau gefunden werden konnte, dann liegt der score bei einem Wert von weniger als 100.
Mögliche Response:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_20120522/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120530_154930_355_7e.jpg","x":4793302.990273163,"y":2806016.128775232,"scale":300000,"width":600,"height":400,"upp":79.37515875031251},"FEATURES":{"keyname":["score"],"COORDS":[{"x":300,"y":200,"keyvalue":["100"]}]},"response_id":"1373b8b9-5273-4225-bc3a-3706484f253b"}
II. returnkey=matchLevel
Der Wert matchLevel gibt Auskunft darüber, mit welcher Adressinformation ein Treffer erzielt wurde.
Mögliche Werte sind:
- houseNumber: Hausnummer
- street: Straßenname
Mögliche Response:
{"MAP":{"url":"http://w-ws-rainer/WO_10R3_20120522/output/Demo-Projekt_f_r_WebOffice_Demo-Projekt_f_r_WebOffice_20120530_154619_154_7c.jpg","x":4793302.990273163,"y":2806016.128775232,"scale":300000,"width":600,"height":400,"upp":79.37515875031251},"FEATURES":{"keyname":["matchLevel"],"COORDS":[{"x":300,"y":200,"keyvalue":["houseNumber"]}]},"response_id":"d2163cfd-1280-4fc0-81f3-1680f179b613"}