Guia do desenvolvedor

Local Navigation

Obter uma localização usando GPS

Seus aplicativos podem recuperar a localização GPS de um aparelho BlackBerry. Os valores para as informações de localização são retornados como as coordenadas para latitude, longitude e altitude.

Você pode especificar os seguintes modos de GPS: modo autônomo, modo assistido e modo de célula. O modo de GPS pode afetar a velocidade inicial de um ponto de GPS e o nível de precisão do local. Por exemplo, um aplicativo climático talvez especifique um modo estação rádio-base, que pode rapidamente fornecer um local aproximado. Para obter mais informações sobre os modelos de aparelho BlackBerry e seus modos GPS correspondentes disponíveis, acesse http://supportforums.blackberry.com/t5/Java-Development/The-BlackBerry-smartphone-models-and-their-corresponding-GPS/ta-p/445329.

Para recuperar informações de localização, você pode usar a API Location, que é composta pela API Location para Java ME (JSR 179), fornecida no pacote javax.microedition.location, ou a extensão do BlackBerry para JSR 179 no pacote net.rim.device.api.gps.

A API JSR 179 Location para Java ME é compatível com aparelhos BlackBerry que executam o BlackBerry Device Software 4.0.2 ou posterior.

As extensões BlackBerry para JSR 179 são compatíveis com aparelhos BlackBerry que executam o BlackBerry Device Software 5.0.0 ou posterior.

Para recuperar a localização do GPS de um aparelho BlackBerry, são necessárias as seguintes ações:

  • Especificar o modo GPS
  • Recuperar um provedor de localização
  • Fazer uma solicitação de GPS baseada na frequência do ponto de GPS
  • Recuperar a localização do GPS de um aparelho BlackBerry

Exemplo de código: Especificar o modo de GPS

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

Exemplo de código: Recuperar um provedor de localização

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

Exemplo de código: Fazer uma solicitação de GPS baseada na frequência do ponto de GPS

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

Exemplo de código: Recuperando a localização do GPS de um aparelho BlackBerry

/* JSR 179 */
double lat = myLoc.getQualifiedCoordinates().getLatitude();
/* BlackBerry extension to JSR 179 */
double lat = myBlackBerryLoc.getQualifiedCoordinates().getLatitude();
Próximo tópico: Especificar o modo de GPS

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