Entwicklungshandbuch

Local Navigation

Abrufen eines Standorts mittels GPS

Ihre Anwendungen können die GPS-Position eines BlackBerry-Geräts abrufen. Die Werte für die Standortinformationen werden als Koordinaten für Breite, Länge und Höhe zurückgegeben.

Sie können die folgenden GPS-Modi festlegen: autonomer Modus, unterstützter Modus und Mobilfunkmodus. Der GPS-Modus kann die anfängliche Geschwindigkeit einer GPS-Positionsbestimmung und den Grad der Standortgenauigkeit beeinflussen. Eine Wetteranwendung könnte beispielsweise den Mobilfunkmodus vorgeben, in dem schnell der ungefähre Standort bereitgestellt werden kann. Weitere Informationen zu den BlackBerry-Gerätemodellen und den entsprechenden verfügbaren GPS-Modi finden Sie unter http://supportforums.blackberry.com/t5/Java-Development/The-BlackBerry-smartphone-models-and-their-corresponding-GPS/ta-p/445329.

Um Standortinformationen abzurufen, können Sie die Location-API verwenden, die aus der Location-API for Java ME (JSR 179) im javax.microedition.location-Paket oder der BlackBerry-Erweiterung für JSR 179 im net.rim.device.api.gps-Paket besteht.

Die JSR 179 Location-API für Java ME wird auf BlackBerry-Geräten unterstützt, auf denen BlackBerry Device Software 4.0.2 oder höher ausgeführt wird.

Die BlackBerry-Erweiterungen für JSR 179 werden auf BlackBerry-Geräten unterstützt, auf denen BlackBerry Device Software 5.0.0 oder höher ausgeführt wird.

Zum Abrufen der GPS-Position eines BlackBerry-Geräts müssen die folgenden Aktionen ausgeführt werden:

  • Festlegen des GPS-Modus
  • Abrufen eines Standortanbieters
  • Senden einer GPS-Anforderung, die auf der Häufigkeit der GPS-Positionsbestimmung basiert
  • Abrufen der GPS-Position eines BlackBerry-Geräts

Codebeispiel: Festlegen des GPS-Modus

/* JSR 179 */
Criteria myCriteria = new Criteria();
/* BlackBerry extension to JSR 179 */
BlackBerryCriteria myBlackBerryCriteria = new BlackBerryCriteria(…);

Codebeispiel: Abrufen eines Standortanbieters

/* JSR 179 */
LocationProvider myProvider = LocationProvider.getInstance(myCriteria);
/* BlackBerry extension to JSR 179 */
BlackBerryLocationProvider myBlackBerryProvider =
    (BlackBerryLocationProvider) LocationProvider.getInstance(myBlackBerryCriteria);

Codebeispiel: Senden einer GPS-Anforderung, die auf der Häufigkeit der GPS-Positionsbestimmung basiert

/*
 * Single GPS fix
 */
/* JSR 179 */
Location myLoc = myProvider.getLocation(…);
/* BlackBerry extension to JSR 179 */
BlackBerryLocation myBlackBerryLoc = myBlackBerryProvider.getLocation(…);
/*
 * Continuous GPS fixes
 */
/* JSR 179 */
myProvider.setLocationListener(…);
/* BlackBerry extension to JSR 179 */
myBlackBerryProvider.setLocationListener(…);

Codebeispiel: Abrufen der GPS-Position eines BlackBerry-Geräts

/* JSR 179 */
double lat = myLoc.getQualifiedCoordinates().getLatitude();
/* BlackBerry extension to JSR 179 */
double lat = myBlackBerryLoc.getQualifiedCoordinates().getLatitude();
Nächstes Thema: Festlegen des GPS-Modus

Waren diese Informationen hilfreich? Senden Sie uns Ihren Kommentar.