HTML5 Geolocation
Vor kurzem habe ich einen Blogpost publiziert der eine Demo zur Geolocation API in HTML5 Browsern demonstriert. Der Post war ohne jede Beschreibung und vermutlich hat der ein oder andere auch gar nichts gesehen (je nach verwendeten Browser).
Das Demo zeigt die Benutzung einer speziellen Methode anhand der Geolocation API. Doch um die Methode und die API zu verstehen muss ich diese erstmal in Gänze darstellen.
Geolocation im Browser
Es gibt diverse Anwendungsfälle die man heute schon mit verschiedenen Endgeräten im Falle der Positionsermittlung benutzt, der bekannteste ist mit Sicherheit ein Navigationssystem das die aktuelle Position mittels GPS ermittelt und den Benutzer daraufhin Navigationshinweise gibt. Viele mobile Endgeräte besitzen heutzutage schon GPS, sogar Foto-Kameras verfügen heutzutage über GPS und erlauben das Taggen von Fotos während der Aufnahmen.
Doch zur Positionsermittlung benötigt man nicht zwangsläufig ein GPS, es gibt andere Verfahren die mal mehr oder weniger genau sind, Ermittlung der IP Adresse, WiFI Triangulation, usw.
Die Möglichkeit nun auch über den Browser die aktuelle Position des Benutzers zu ermitteln erschließt ein noch breiteres Spektrum an Anwendungsmöglichkeiten. Schliesslich sind HTML5 Browser nicht nur auf dem Desktop zu Hause, sondern auch auf mobilen Endgeräten.
Und damit erschließen sich viele Einsatzszenarien die bisher technisch einen durchaus größeren Mehraufwand bedeutet haben. Neben der traditionellen Navigationssoftware könnte die unterstützende Suche anhand der Benutzerposition, Automatisierte Warnhinweise über Ereignisse die in der Nähe des Benutzers passieren, Benachrichtigungen über Freunde aus dem sozialen Netzwerk die in der Nähe sind und viele andere Szenarien mit recht geringen Aufwand implementiert werden. Die eigentliche Arbeit macht in diesem Fall der Browser. Dank der Geolocation API bekommt man die Daten fertig aufbereitet über einen Callback und kann entsprechend Logik ansteuern.
Geolocation API
Die Geolocation API Spezifikation findet man beim W3C http://www.w3.org/TR/geolocation-API/. Sie ist im Simpel und verfügt alles in allem über drei Methoden.
getCurrentPosition und watchPosition
Die Methode getCurrentPosition() ermittelt einen einmaligen Geolocation Snapshot. Sprich die Position des Benutzers wird einmal abgefragt und das Ergebnis kommt im positiven Falle in den Callback zurück. Die Signatur der Methode ist folgendermaßen:
void getCurrentPosition(in PositionCallback successCallback,
in optional PositionErrorCallback errorCallback,
in optional PositionOptions options);
Bevor ich ein Beispiel zeige möchte ich zuerst auf die zwei optionalen Parameter eingehen. PositionErrorCallback und PositionOptions. Der PositionErrorCallback liefert ein PositionError Objekt zurück. Dieses besteht aus einem Fehlercode und der Fehlernachricht. Mit PositionOptions kann man die Genauigkeit, einen Timout Wert sowie das Alter der im Cache befindlichen Geolocation bestimmen.
Diese zwei optionalen Parameter werden auch für den watchPosition Aufruf verwendet.
Nun kommt der eigentliche Callback der im Falle des Erfolges ein Objekt mit den Positionsdaten rein gibt: Position.
Position
Position enthält einen Zeitstempel, die aufbereiteten Geolocation-Daten und kann je nach verwendetem Browser und Möglichkeiten im Endgerät neben Längen- und Breitengrad auch Ausrichtung, Geschwindigkeit und Höhe über NN enthalten. Hier die Definition des Position Objektes:
interface Position {
readonly attribute Coordinates coords;
readonly attribute DOMTimeStamp timestamp;
};
interface Coordinates {
readonly attribute double latitude;
readonly attribute double longitude;
readonly attribute double? altitude;
readonly attribute double accuracy;
readonly attribute double? altitudeAccuracy;
readonly attribute double? heading;
readonly attribute double? speed;
};
Die Methode watchPosition ist im Prinzip genauso anzuwenden wie getCurrentPosition, der Unterschied ist allerdings das der Callback jedesmal bei Veränderungen aufgerufen wird. Dieses Verhalten ist stark Endgeräte- und Situationsabhängig. Zum Beispiel bei einer Zugfahrt per UMTS können so die unterschiedlichen Einwahlpunkte der UMTS Zelle dargestellt werden, während beim Desktop am Schreibtisch hier nichts nähre passiert. watchPosition liefert eine Id als Rückgabewert. Denn wie der Methodenname schon sagt wird eben die Position die gesamte Zeit verfolgt. Möchte man dies beenden so muss man lediglich diese Id an die Methode clearWatch() übergeben.
Weiter zur Seite 2 von 3
HTML5 Geolocation
Geolocation im Browser (Seite 1)