Guide de développement

Local Navigation

Récupération d'une position avec le GPS

Vos applications peuvent récupérer la position GPS d'un terminal BlackBerry. Les valeurs des informations de position sont renvoyées sous forme de coordonnées pour la latitude, la longitude et l'altitude.

Vous pouvez indiquer les modes GPS suivants : mode autonome, mode assisté et mode site cellulaire. Le mode GPS peut affecter la vitesse initiale d'obtention de votre position GPS actuelle et le niveau de précision du positionnement. Par exemple, une application météorologique pourrait indiquer un mode site cellulaire, qui peut fournir rapidement un positionnement approximatif. Pour plus d'informations à propos des modèles de terminaux BlackBerry et de leurs modes GPS correspondants disponibles, rendez-vous à l'adresse http://supportforums.blackberry.com/t5/Java-Development/The-BlackBerry-smartphone-models-and-their-corresponding-GPS/ta-p/445329.

Pour récupérer des informations de position, vous pouvez utiliser l'API de positionnement, intégrant l'API de positionnement Java ME (JSR 179), fournie dans le progiciel javax.microedition.location ou l'extension BlackBerry JSR 179 dans le progiciel net.rim.device.api.gps.

L'API de positionnement JSR 179 pour Java ME est prise en charge sur les terminaux BlackBerry qui exécutent BlackBerry Device Software 4.0.2 ou version ultérieure.

Les extensions BlackBerry pour JSR 179 sont prises en charge sur les terminaux BlackBerry qui exécutent BlackBerry Device Software 5.0.0 ou version ultérieure.

La récupération de la position GPS d'un terminal BlackBerry implique les actions suivantes :

  • Indication du mode GPS
  • Identification du fournisseur de positionnement
  • Envoi d'une requête GPS reposant sur la fréquence d'obtention de votre position GPS actuelle
  • Récupération de la position GPS d'un terminal BlackBerry

Échantillon de code : spécification du mode GPS

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

Échantillon de code : récupération d'un fournisseur de positionnement

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

Échantillon de code : envoi d'une requête GPS selon la fréquence d'obtention de votre position GPS actuelle

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

Échantillon de code : récupération de la position GPS d'un terminal BlackBerry

/* JSR 179 */
double lat = myLoc.getQualifiedCoordinates().getLatitude();
/* BlackBerry extension to JSR 179 */
double lat = myBlackBerryLoc.getQualifiedCoordinates().getLatitude();

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.