Guide de développement

Local Navigation

Récupération d'une position GPS à l'aide d'une page Web

Vous pouvez utiliser JavaScript pour configurer le mode GPS et déterminer le positionnement actuel du terminal BlackBerry à l'aide de BlackBerry Browser.

Vous pouvez utiliser les propriétés et les méthodes JavaScript suivantes pour accéder à l'API de positionnement à partir de BlackBerry Browser.

Propriété JavaScript

Description

blackberry.location.GPSSupported

Cette propriété renvoie true lorsque le GPS est pris en charge par le terminal BlackBerry.

blackberry.location.latitude

Cette propriété renvoie la latitude actuelle, en degrés, du terminal BlackBerry. Les valeurs positives indiquent une latitude nord, les valeurs négatives indiquent une latitude sud.

blackberry.location.longitude

Cette propriété renvoie la longitude actuelle, en degrés, du terminal BlackBerry. Les valeurs positives indiquent une longitude est, les valeurs négatives indiquent une longitude ouest.

blackberry.location.timestamp

Cette propriété renvoie le temps (en millisecondes depuis l'époque) auquel l'objet blackberry.location a été mis à jour.

Méthode JavaScript

Description

blackberry.location.setAidMode(mode)

Cette méthode indique quel mode GPS le terminal BlackBerry utilisera pour déterminer la position GPS. Le mode peut être n'importe laquelle des valeurs suivantes :

  • 0 pour le mode site cellulaire
  • 1 pour le mode assisté
  • 2 pour le mode autonome

blackberry.location.refreshLocation()

Cette méthode nécessite une mise à jour du positionnement du terminal BlackBerry. Cette méthode est asynchrone, donc le script continue sans tenir compte de la réception des informations de positionnement mises à jour. Pour garantir que les informations d'emplacement sont mises à jour avant de les lire, vous devriez d'abord enregistrer un écouteur utilisant blackberry.location.onLocationUpdate() qui lit blackberry.location.latitude et blackberry.location.longitude, puis appeler refreshLocation().

blackberry.location.onLocationUpdate("callback")

Cette méthode enregistre un écouteur qui évalue une chaîne ou appelle une fonction quand le terminal BlackBerry reçoit des informations de positionnement mises à jour.

Sur les terminaux BlackBerry exécutant des versions de BlackBerry Device Software antérieures à la version 4.6, cette fonction doit être transmise comme une chaîne évaluée à chaque fois que le positionnement est actualisé. Sur les terminaux BlackBerry exécutant BlackBerry Device Software version 4.6 ou ultérieure, vous pouvez transmettre une chaîne ou utiliser la méthode pour inscrire une fonction de rappel.

Lorsque onlocationUpdate() a été appelé, le rappel se produit quand les informations de positionnement sont mises à jour.

La fréquence peut être de plusieurs secondes. Si vous avez transmis une fonction à la méthode, vous pouvez annuler le rappel à l'aide de blackberry.location.removeLocationUpdate(). Si vous avez transmis une chaîne, le rappel ne peut pas être supprimé.

blackberry.location.removeLocationUpdate()

Cette méthode supprime une fonction de rappel inscrite auparavant. Cette méthode est uniquement prise en charge sur les terminaux BlackBerry exécutant BlackBerry Device Software version 4.6 ou ultérieure.


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