Entwicklungshandbuch

Local Navigation

Abrufen einer GPS-Position mithilfe einer Webseite

Sie können den GPS-Modus mithilfe von JavaScript konfigurieren und den aktuellen Standort des BlackBerry-Geräts mit dem BlackBerry Browser bestimmen.

Mithilfe der folgenden JavaScript-Eigenschaften und -Methoden können Sie vom BlackBerry Browser aus auf die Location API zugreifen.

JavaScript-Eigenschaft

Beschreibung

blackberry.location.GPSSupported

Diese Eigenschaft gibt true zurück, wenn das BlackBerry-Gerät GPS unterstützt.

blackberry.location.latitude

Diese Eigenschaft gibt den aktuellen Breitenwert des BlackBerry-Geräts in Grad zurück. Positive Werte geben nördliche Breite und negative Werte südliche Breite an.

blackberry.location.longitude

Diese Eigenschaft gibt den aktuellen Längenwert des BlackBerry-Geräts in Grad zurück. Positive Werte geben östliche Länge und negative Werte westliche Länge an.

blackberry.location.timestamp

Diese Eigenschaft gibt den Zeitpunkt (in Millisekunden seit Epoche) zurück, zu dem das blackberry.location-Objekt aktualisiert wurde.

JavaScript-Methode

Beschreibung

blackberry.location.setAidMode(mode)

Mit dieser Methode wird festgelegt, welchen GPS-Modus das BlackBerry-Gerät zur Bestimmung der GPS-Position verwendet. Der Modus kann einer der folgenden Werte sein:

  • 0 für den Mobilfunkmodus
  • 1 für den unterstützten Modus
  • 2 für den autonomen Modus

blackberry.location.refreshLocation()

Mit dieser Methode wird eine Aktualisierung des Standorts des BlackBerry-Geräts angefordert. Diese Methode ist asynchron, so dass das Skript unabhängig davon fortgesetzt wird, ob aktualisierte Standortinformationen empfangen wurden. Um sicherzustellen, dass die Standortinformationen aktualisiert werden, bevor sie gelesen werden, sollten Sie zuerst mithilfe von blackberry.location.onLocationUpdate() einen Listener registrieren, der blackberry.location.latitude und blackberry.location.longitude liest, und anschließend refreshLocation() aufrufen.

blackberry.location.onLocationUpdate("callback")

Mit dieser Methode wird ein Listener registriert, der eine Zeichenfolge auswertet oder eine Funktion aufruft, wenn das BlackBerry-Gerät aktualisierte Standortinformationen empfängt.

Auf BlackBerry-Geräten, auf denen ältere Versionen der BlackBerry Device Software als Version 4.6 ausgeführt werden, muss diese Funktion als eine Zeichenfolge übergeben werden, die bei jeder Aktualisierung des Standorts ausgewertet wird. Auf BlackBerry-Geräten mit BlackBerry Device Software Version 4.6 oder höher können Sie eine Zeichenfolge übergeben oder mithilfe der Methode eine Rückruffunktion registrieren.

Nachdem onlocationUpdate() aufgerufen wurde, findet der Rückruf bei jeder Aktualisierung der Standortinformationen statt.

Dies kann in Intervallen von wenigen Sekunden erfolgen. Wenn Sie eine Funktion an die Methode übergeben haben, können Sie den Rückruf mithilfe von blackberry.location.removeLocationUpdate() abbrechen. Wenn Sie eine Zeichenfolge übergeben haben, kann der Rückruf nicht entfernt werden.

blackberry.location.removeLocationUpdate()

Mit dieser Methode wird eine zuvor registrierte Rückruffunktion entfernt. Diese Methode wird nur auf BlackBerry-Geräten unterstützt, auf denen BlackBerry Device Software Version 4.6 oder höher ausgeführt wird.


Waren diese Informationen hilfreich? Senden Sie uns Ihren Kommentar.