Mit dieser GET_RELATION kann die lokale Geo-Coordinate des aktuellen Browser des Benutzers abgefragt werden. Es ist zu Beachten, dass diese Abfrage nur dann möglich ist, wenn folgende Vorraussetzungen erfüllt werden:
- GEO-Location Subsystem ist im WW-Server aktiviert
- GEO-Location Zugriff ist für Browser-Art aktiviert (Desktop/Tablet/Mobile)
- Der verwendete Browser unterstützt die Geo-Location API
- Der Benutzer hat dem Zugriff auf die Geo-Location zugestimmt
Der Aufruf der Relation erfolgt folgenden zwei Parametern: [4023!MODE!MaxTimeOut!]
MODE ▶
0: Ermittele die aktuelle Position direkt vom Browser
1: Hole die letzte ermittelte Position für die Sitzung vom WW-Server
2: Hole die Uhrzeit der letzten ermittelten Position vom WW-Server
3: Hole die Adress-Informationen der zuletzt ermittelten Position vom WW-Server (noch nicht
verfügbar)
MaxTimeOut ▶
Da die Ermittlung der Position nicht direkt von der Anwendung durchgeführt wird, sondern entweder vom Browser (Mode=0) oder WW-Server (Mode=1,2,3) ermittelt wird, kann die Ermittlung einige Zeit in Anspruch nehmen.
Hier können Sie eine maximale Wartezeit auf die Antwort in Sekunden angeben. Bei Angabe von „0“ wird endlos gewartet. Die Anwendung bleibt dabei solange im Wartemodus bis entweder der Time-Out eintritt oder die Daten angekommen sind. Hinweis: Die Zeit wird vom System um eine Sekunde erhöht.
Rückgabe der Funktion ▶
Folgende Rückgabe-Codes werden von der Anwendung übergeben.
Dabei wird jeweils das erste Byte der Rückgabe mit dem Rückgabecode sowie die folgenden Bytes mit den Antwortdaten gefüllt:
0: OK Erfolgreich Werte abhängig von der Anfrage
1: FEHLER Geo-Location nicht im WW-Server aktiviert
2: FEHLER Geo-Location icht für die Browser-Type der Sitzung aktiviert
3: FEHLER aktueller Browser unterstützt keine Geo-Location
4: FEHLER Benutzer hat die Abfrage der Geo-Location abgelehnt
5: TIMEOUT-Fehler, die Antwort kam nicht in der gewünschten Antwortzeit
Rückgabedetails bei Return-Code 0
Aufruf Mode 0 + 1 ▶
Position 1..20 Longitude, 21..40 Latitude
Arufruf Mode 2 ▶
Position 1..20 Datum letzter Ermittlung, 21..40 Uhrzeit letzte Ermittlung
Auruf Mode 3 ▶
(Noch nicht implementiert!!) Gebe Adress-Info Position: 1..128