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

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

• Especificar o modo de GPS
  
• Especificação do modo GPS usando o JSR 179
  
• Especificar o modo de GPS com o uso de extensões BlackBerry para JSR 179
  
• Recuperar informações de localização usando o modo de GPS assistido
  
• Recuperar um provedor de localização
  
• Recuperar a localização de um aparelho BlackBerry
  
• Manipulação de erro
  
• Recuperar uma localização do GPS usando uma página da Web