HTML and CSS Reference
In-Depth Information
}
function handleError(error)
{
...
}
// One Shot Anfrage
var options {timeout:30000, maximumAge:300000, enableHighAccuracy:false};
navigator.geolocation.getCurrentPosition(showMap, handleError, options);
Obwohl der zweite und dritte Parameter - hier
handleError
,
options
- optional sind,
sollte man auf die Implementierung nicht verzichten.
showMap
wird im obigen Beispiel
aufgerufen, sobald der Benutzer der Ortsbestimmung zugestimmt hat und die Position
festgestellt werden konnte. Ob das der Fall war, hängt auch von den Positionsoptionen
ab, die als dritter Parameter übergeben werden.
Falls eine Bestimmung nach Vorgabe der
PositionOptions
nicht möglich war, wird
handleError
aufgerufen und ein
error
-Objekt übergeben. Das
PositionOptions
-
Objekt ist optional und kann folgende Eigenschaften enthalten:
PositionOptions-Objekteigenschaften
Gibt die maximale Dauer der Positionsbestimmung an. Der Wert
wird in Millisekunden angegeben, im obigen Beispiel also 30
Sekunden. Sobald diese Dauer überschritten ist, wird die Error-
Callback-Funktion aufgerufen. Die hier angegebene Dauer
betrifft lediglich den Prozess der Ortsbestimmung. Falls der Nut-
zer also zunächst um die Zustimmung gefragt werden muss, hat
der Bestimmungsprozess ab dem Zeitpunkt der Zustimmung
den hier angegebenen Wert.
long timeout
Gibt an, ob auch eine zuvor bereits ermittelte Position zurückge-
geben werden kann. Das bietet sich oftmals an, da so die Dauer
der Ortsbestimmung deutlich reduziert werden kann, obgleich
die Qualität der Position natürlich je nach Veränderung der rea-
len Position deutlich abnimmt. Dieser Wert wird auch in Millise-
kunden angegeben, im obigen Beispiel wird also eine Position
akzeptiert, die maximal 5 Minuten (300 Sekunden) alt ist.
long maximumAge
Da die meisten Geräte, die die Geolocation-API implementieren,
mehrere Möglichkeiten zur Ortsbestimmung haben, wird über
diese Eigenschaft angegeben, ob man die Methode benutzen
möchte, die die größte Genauigkeit bietet. In den allermeisten
Fällen wird hierdurch der GPS-Chip des Geräts bemüht, die Posi-
tion zu bestimmen. Das kann je nach Gerät über 30 Sekunden
dauern. Viel schneller, jedoch auch ungenauer, ist die Bestim-
mung per Wifi-Netzwerk in Reichweite oder IP-Adressen der Wifi-
Gateways.
boolean
enableHighAccuracy
