Le applicazioni possono recuperare la posizione GPS di un dispositivo BlackBerry. Le informazioni sulla posizione vengono restituite come coordinate di latitudine, longitudine e altitudine.

È possibile specificare le modalità GPS seguenti: autonoma, autonoma assistita e cella radio. La modalità GPS può influenzare la velocità iniziale di un fix GPS e il livello di accuratezza della posizione. Ad esempio, un'applicazione meteo può specificare la modalità Cella radio, che fornisce rapidamente una posizione approssimativa. Per ulteriori informazioni sui modelli di dispositivi BlackBerry e le modalità GPS corrispondenti disponibili, visitare il sito Web http://supportforums.blackberry.com/t5/Java-Development/The-BlackBerry-smartphone-models-and-their-corresponding-GPS/ta-p/445329.

Per recuperare le informazioni sulla posizione, è possibile utilizzare l'API Location. Tale AP è disponibile come Location API per Java ME (JSR 179), fornita nel pacchetto javax.microedition.location oppure come estensione BlackBerry allo standard JSR 179, fornita nel pacchetto net.rim.device.api.gps.

Location API per Java ME (JSR 179) è supportata dai dispositivi BlackBerry con BlackBerry Device Software versione 4.0.2 o successiva.

Le estensioni BlackBerry allo standard JSR 179 sono supportate dai dispositivi BlackBerry con BlackBerry Device Software versione 5.0.0 o successive.

Per recuperare la posizione GPS di un dispositivo BlackBerry, è necessario eseguire le operazioni seguenti:

• Specificare la modalità di GPS
• Recuperare un provider di posizioni
• Creare una richiesta GPS basata sulla frequenza dei fix GPS
• Recuperare la posizione GPS del dispositivo BlackBerry

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

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

/*
 * 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(…);

/* JSR 179 */
double lat = myLoc.getQualifiedCoordinates().getLatitude();
/* BlackBerry extension to JSR 179 */
double lat = myBlackBerryLoc.getQualifiedCoordinates().getLatitude();

• Specifica della modalità GPS
  
• Specifica della modalità GPS tramite JSR 179
  
• Specifica della modalità GPS utilizzando le estensioni di BlackBerry che includono JSR 179
  
• Recupero delle informazioni sulla posizione utilizzando la modalità GPS assistita
  
• Recupero di un provider di posizioni
  
• Recupero della posizione di un dispositivo BlackBerry
  
• Gestione degli errori
  
• Recupero di una posizione GPS utilizzando una pagina Web