Help Center

Local Navigation

BlackBerry Manuals & Help  >  Developer Documentation  >  Java Development Guides and API Reference  >  Development Guide Location-Based Services - BlackBerry Java Application - 5.0

Handle errors (BlackBerry extensions to JSR 179)

You can check the status of a GPS fix request by invoking the getStatus() method that is provided in the BlackBerry® extensions to JSR 179. If the return is BlackBerryLocation.GPS_ERROR, you can retrieve the error value by invoking BlackBerryLocation.getError().
  1. Import the required classes and interfaces. 
    import net.rim.device.api.gps.*;
import javax.microedition.location.*;
  2. Create a class and a constructor. 
    public class handleGPS
{
    public handleGPS()
    {
    }
}
  3. In the constructor, create a try/catch block. In this block, create an instance of the BlackBerryCriteria class by passing the GPS mode to the constructor. 
    try
{
    BlackBerryCriteria myCriteria =
      new BlackBerryCriteria(GPSInfo.GPS_MODE_ASSIST);
}
catch ( UnsupportedOperationException ex )
{
    return;
}
  4. In the try/catch block, create another try/catch block. In this block, create an instance of the BlackBerryLocationProvider class by retrieving the BlackBerryCriteria object. Invoke setLocationListener() to specify the location listener. 
    try
{
    BlackBerryLocationProvider myProvider =
        (BlackBerryLocationProvider)LocationProvider.getInstance(myCriteria);
    myProvider.setLocationListener(new myLocationListener(), -1, -1, -1);
}
catch ( LocationException lex )
{
    return;
}
  5. In the class, create a static class that implements LocationListener. Implement locationUpdated() and providerStateChanged(). 
    private static class myLocationListener implements LocationListener
{
    public void locationUpdated(LocationProvider provider, Location location)
    {
    }

    public void providerStateChanged(LocationProvider provider, int newState)
    {
    }
}
  6. In locationUpdated(), verify if the location parameter is an instance of BlackBerryLocation. If so, then create a local BlackBerryLocation object by passing the location parameter. Invoke getStatus() to retrieve the status of GPS location request, and then process the returned status. 
    if (location instanceof BlackBerryLocation)
{
    BlackBerryLocation bLoc = (BlackBerryLocation)location;

    switch(bLoc.getStatus())
    {
        case BlackBerryLocation.GPS_ERROR:
            int gpsStatus = bLoc.getError();
            break;

        case BlackBerryLocation.FAILOVER_MODE_ON:
        case BlackBerryLocation.SUBSEQUENT_MODE_ON:
        case BlackBerryLocation.GPS_FIX_PARTIAL:
        case BlackBerryLocation.GPS_FIX_COMPLETE:
            break;
    }
}

Code sample: Handling errors (BlackBerry extensions to JSR 179) 

import net.rim.device.api.gps.*;
import javax.microedition.location.*;

public class handleGPS
{
    public handleGPS()
    {
        try
        {
            BlackBerryCriteria myCriteria =
              new BlackBerryCriteria(GPSInfo.GPS_MODE_ASSIST);

            try
            {
                BlackBerryLocationProvider myProvider =
                  (BlackBerryLocationProvider)
                    LocationProvider.getInstance(myCriteria);
                myProvider.setLocationListener
                  (new myLocationListener(), -1, -1, -1);
            }
            catch ( LocationException lex )
            {
                return;
            }
        }
        catch ( UnsupportedOperationException ex )
        {
            return;
        }
    }

    private static class myLocationListener implements LocationListener
    {
        public void locationUpdated
          (LocationProvider provider, Location location)
        {
            if (location instanceof BlackBerryLocation)
            {
                BlackBerryLocation bLoc = (BlackBerryLocation)location;

                switch(bLoc.getStatus())
                {
                    case BlackBerryLocation.GPS_ERROR:
                        int gpsStatus = bLoc.getError();
                        break;

                    case BlackBerryLocation.FAILOVER_MODE_ON:
                    case BlackBerryLocation.SUBSEQUENT_MODE_ON:
                    case BlackBerryLocation.GPS_FIX_PARTIAL:
                    case BlackBerryLocation.GPS_FIX_COMPLETE:
                        break;
                }
            }
        }

        public void providerStateChanged
          (LocationProvider provider, int newState)
        {
        }
    }
}
Parent topic: Retrieving the location of a BlackBerry device

Was this information helpful? Send us your comments.