I seguenti passaggi mostrano come creare un'applicazione dell'interfaccia utente che fornisca aggiornamenti continui sulla posizione, recuperando fix GPS quando disponibili o entro un periodo di timeout specificato. Se il fix GPS non è disponibile, viene restituito un fix di geolocation.

1. Importare le classi e le interfacce richieste.

   import net.rim.device.api.gps.*;
   import net.rim.device.api.system.Application;
   import net.rim.device.api.ui.*;
   import net.rim.device.api.ui.component.*;
   import net.rim.device.api.ui.container.*;
   import javax.microedition.location.*;

2. Creare il framework dell'applicazione estendendo la classe UiApplication. Creare una variabile di tipo numero intero e assegnarle il valore 1, che specifica l'intervallo di aggiornamento delle coordinate di posizione. Creare una variabile con il tipo EditField per memorizzare gli aggiornamenti sulla posizione che vengono visualizzati sulla schermata. In main(), creare un'istanza della nuova classe e richiamare enterEventDispatcher() per abilitare l'applicazione a ricevere gli eventi. Nel costruttore dell'applicazione, creare un'istanza della classe MultipleFixScreen, come descritto al passaggio 7. Richiamare setTitle() per specificare il titolo della schermata. Creare un'istanza della classe EditField e aggiungere il campo alla schermata. Richiamare startLocationUpdate(), come descritto al passaggio 4, per avviare il recupero degli aggiornamenti sulla posizione. Richiamare pushScreen() per visualizzare la schermata personalizzata per l'applicazione.

   public class MultipleFixDemo extends UiApplication 
   {    
       private static int _interval = 1;
       private EditField _status;    
       public static void main(String[] args)
       {
           new MultipleFixDemo().enterEventDispatcher();
       }
       public MultipleFixDemo()
       {
           MultipleFixScreen screen = new MultipleFixScreen();
           screen.setTitle("Multiple Fix Demo");
           _status = new EditField(Field.NON_FOCUSABLE);
           screen.add(_status);
           startLocationUpdate();
           pushScreen(screen);
       }
   }

3. Creare un metodo updateLocationScreen che richiama invokeLater() per aggiungere questa sezione di codice alla coda di eventi dell'applicazione. Creare un'istanza della classe Runnable e passarla come parametro a invokeLater(). Sovrascrivere run() nella definizione di Runnable. Richiamare setText() per visualizzare i risultati sulla schermata.

   private void updateLocationScreen(final String msg)
   {
       invokeLater(new Runnable()
       {
           public void run()
           {
               _status.setText(msg);
           }
       });
   }

4. Creare il framework per il metodo startLocationUpdate. Creare un blocco try/catch per specificare i criteri per recuperare una posizione. Creare un'istanza della classe BlackBerryCriteria richiamando BlackBerryCriteria(). Viene utilizzata la modalità di posizione predefinita perché non vengono passati argomenti a BlackBerryCriteria(). Richiamare enableGeolocationWithGPS() per specificare il recupero di un fix GPS, se disponibile, o per recuperare un fix di geolocation se il fix GPS non è disponibile. Nel blocco catch, aggiungere un UnsupportedOperationException, che indica che la modalità di posizione non è supportata.

   private void startLocationUpdate()
   {
       try
       {
           BlackBerryCriteria myCriteria = new BlackBerryCriteria();
           myCriteria.enableGeolocationWithGPS();
       catch (UnsupportedOperationException ue)
       {
           System.err.println("Require mode is unavailable");
           System.err.println(ue); 
           System.exit(0);   
       }
       return;
   }

5. Nel primo blocco try, creare un secondo blocco try/catch per recuperare un provider di posizioni. Richiamare LocationProvider.getInstance() con l'oggetto BlackBerryCriteria per recuperare un provider di posizioni. Creare un'istanza Runnable e passarla come parametro a invokeLater(). Sovrascrivere run() nella definizione di Runnable verrà visualizzato un messaggio per indicare che non è possibile recuperare il provider di posizioni. Richiamare setLocationListener() passando il valore di intervallo, il valore di timeout e la durata massima come parametri per registrare un listener quando un provider di posizioni è disponibile. Nel blocco catch, aggiungere un LocationException, che indica che il provider di posizione non è disponibile.

   try
   {
       BlackBerryLocationProvider myProvider = (BlackBerryLocationProvider)
               LocationProvider.getInstance(myCriteria);
       if ( myProvider == null )
       {
           Runnable showUnsupportedDialog = new Runnable() 
           {
               public void run() 
               {
                   Dialog.alert("Location service unsupported, exiting...");
                   System.exit( 1 );
               }
            };
            invokeLater( showUnsupportedDialog );  
        }
        else
        {
            myProvider.setLocationListener(new LocationListenerImpl(), 
                    _interval, 1, 1);
        }
   }
   catch (LocationException le)
   {
       System.err.println("Failed to retrieve a location provider");
       System.err.println(le); 
       System.exit(0);
   }

6. Creare una seconda classe che implementa LocationListener. Implementare locationUpdated() per fornire gli aggiornamenti sulla posizione. Creare un'istruzione if per verificare se la posizione è valida. Se la posizione è valida, recuperare le coordinate della longitudine, della latitudine e dell'altitudine richiamando, rispettivamente, getLongitude(), getLatitude() egetAltitude(). Creare un'istanza della classe StringBuffer e aggiungere le coordinate risultanti al buffer. Richiamare updateLocationScreen() per visualizzare le coordinate risultanti sulla schermata.

   private class LocationListenerImpl implements LocationListener
   {
       public void locationUpdated(LocationProvider provider, Location location)
       {
           if(location.isValid())
           {
               double longitude = location.getQualifiedCoordinates()
                       .getLongitude();
               double latitude = location.getQualifiedCoordinates()
                       .getLatitude();
               float altitude = location.getQualifiedCoordinates()
                       .getAltitude();
               StringBuffer sb = new StringBuffer();
               sb.append("Longitude: ");
               sb.append(longitude);
               sb.append("\n");
               sb.append("Latitude: ");
               sb.append(latitude);
               sb.append("\n");
               sb.append("Altitude: ");
               sb.append(altitude);
               sb.append(" m");
               MultipleFixDemo.this.updateLocationScreen(sb.toString());
           }
       }
       public void providerStateChanged(LocationProvider provider, int newState)
       {
           // Not implemented
       }        
   }

7. Creare il framework della schermata personalizzata estendendo la classe MainScreen. Nel costruttore della schermata, richiamare super() per creare un menu predefinito. Creare un'istanza RichTextField per visualizzare un messaggio informativo. Richiamare add() per aggiungere RichTextField alla schermata.

   private final static class MultipleFixScreen extends MainScreen
   {
       MultipleFixScreen()
       {
           super(DEFAULT_CLOSE | DEFAULT_MENU);
           RichTextField instructions = new RichTextField(
                   "Waiting for location update...",Field.NON_FOCUSABLE);
           this.add(instructions);
       }
   }