Guia do desenvolvedor

Local Navigation

Recuperar informações de satélite usando a classe BlackBerryLocation

Você pode solicitar um ponto de GPS e então recuperar o número atual de satélites em exibição, satélites rastreados, qualidade média do sinal de satélite, origem de dados do GPS (GPS interno ou externo) e o modo de GPS.

  1. Importe as classes necessárias.
    import java.util.*;
    import java.lang.*;
    import net.rim.device.api.gps.*;
  2. Crie uma classe e um construtor.
    public class handleGPS
    {
       public handleGPS()
       {
       }
    }
  3. Na classe, defina campos estáticos para um thread e para cada item de informação de localização que você recuperar.
    static GPSThread gpsThread;
    static int satCount;
    static int signalQuality;
    static int dataSource;
    static int gpsMode;
  4. No construtor, crie e inicie um thread.
    gpsThread = new GPSThread();
    gpsThread.start();
  5. Na classe, crie uma classe estática privada que estenda Thread e um método run().
    private static class GPSThread extends Thread
    {
        public void run()
        {
        }
    }
  6. Em run(), crie um bloco try/catch. Nesse bloco, crie uma instância da classe BlackBerryCriteria que especifica o modo de GPS. Crie um segundo bloco try/catch. Nesse bloco, crie uma instância da classe BlackBerryLocationProvider recebendo uma instância do objeto BlackBerryCriteria.
    try
    {
        BlackBerryCriteria myCriteria = new BlackBerryCriteria(GPSInfo.GPS_MODE_AUTONOMOUS);
        try
        {
            BlackBerryLocationProvider myProvider =
                (BlackBerryLocationProvider)LocationProvider.getInstance(myCriteria);
    
  7. Crie um terceiro bloco try/catch que está no primeiro bloco try/catch. Crie um objeto BlackBerryLocation para carregar o reparo de GPS incluindo expiração do limite de tempo de 300 segundos. Preencha os campos e extraia as informações de satélite em um objeto StringBuffer.
    try
    {
        BlackBerryLocation myLocation =
            (BlackBerryLocation)myProvider.getLocation(300);
        satCount= myLocation.getSatelliteCount();
        signalQuality = myLocation.getAverageSatelliteSignalQuality();
        dataSource = myLocation.getDataSource();
        gpsMode = myLocation.getGPSMode();
        SatelliteInfo si;
        StringBuffer sb = new StringBuffer("[Id:SQ:E:A]\n");
        String separator = ":";
        for (Enumeration e = myLocation.getSatelliteInfo();
            e!=null && e.hasMoreElements(); )
        {
            si = (SatelliteInfo)e.nextElement();
            sb.append(si.getId() + separator);
            sb.append(si.getSignalQuality() + separator);
            sb.append(si.getElevation() + separator);
            sb.append(si.getAzimuth());
            sb.append('\n');
        }
    }
    catch ( InterruptedException iex )
    {}
    catch ( LocationException lex )
    {}

Estas informações foram úteis? Gostaríamos de receber seus comentários.