Guida allo sviluppo

Local Navigation

Recupero di una posizione GPS utilizzando una pagina Web

È possibile utilizzare JavaScript per configurare la modalità GPS e stabilire la posizione attuale del dispositivo BlackBerry mediante BlackBerry Browser.

È possibile utilizzare le seguenti proprietà e i seguenti metodi JavaScript per accedere alla API Location da BlackBerry Browser.

Proprietà di JavaScript

Descrizione

blackberry.location.GPSSupported

Questa proprietà restituisce true quando la funzionalità GPS è supportata dal dispositivo BlackBerry.

blackberry.location.latitude

Questa proprietà restituisce la latitudine attuale, espressa in gradi, del dispositivo BlackBerry. I valori positivi indicano la latitudine Nord; i valori negativi indicano la latitudine Sud.

blackberry.location.longitude

Questa proprietà restituisce la longitudine attuale, espressa in gradi, del dispositivo BlackBerry. I valori positivi indicano la longitudine Est; i valori negativi indicano la longitudine Ovest

blackberry.location.timestamp

Questa proprietà restituisce l'ora (espressa in millisecondi a partire dall'epoch) in cui l'oggetto blackberry.location è stato aggiornato.

Metodo di JavaScript

Descrizione

blackberry.location.setAidMode(mode)

Questo metodo specifica quale modalità GPS il dispositivo BlackBerry utilizzerà per stabilire la posizione GPS. La modalità può essere espressa da uno dei seguenti valori:

  • 0 per la modalità Cella Radio
  • 1 per la modalità Assistita
  • 2 per la modalità Autonoma

blackberry.location.refreshLocation()

Questo metodo richiede un aggiornamento della posizione del dispositivo BlackBerry. Questo metodo è asincrono. In questo modo lo script continua indipendentemente dal fatto che le informazioni di posizione aggiornate siano state ricevute. Per garantire che le informazioni di posizione vengano aggiornate prima di essere lette, è necessario registrare prima un listener utilizzando blackberry.location.onLocationUpdate() che legga blackberry.location.latitude e blackberry.location.longitude , quindi chiamare successivamente refreshLocation().

blackberry.location.onLocationUpdate("callback")

Questo metodo registra un listener che valuta una stringa o chiama una funzione quando il dispositivo BlackBerry riceve informazioni di posizione aggiornate.

Sui dispositivi BlackBerry che eseguono le versioni di BlackBerry precedenti alla 4.6, questa funzione deve essere passata come stringa che viene valutata ogni volta che è aggiornata la posizione. Sui dispositivi BlackBerry che eseguono BlackBerry versione 4.6 o successiva, è possibile passare una stringa o utilizzare il metodo per registrare una funzione di richiamata.

Una volta chiamato onlocationUpdate(), la richiamata si verifica tutte le volte in cui è presente un aggiornamento per le informazioni di posizione.

La frequenza della richiamata può avere un intervallo di qualche secondo. Se al metodo è stata passata una funzione, è possibile annullare la richiamata utilizzando blackberry.location.removeLocationUpdate(). Se è stata passata una stringa, la richiamata non può essere rimossa.

blackberry.location.removeLocationUpdate()

Questo metodo rimuove una funzione di richiamata precedentemente registrata. Questo metodo è supportato solamente dai dispositivi BlackBerry che eseguono BlackBerry versione 4.6 o successiva.


Le informazioni sono state utili? Inviateci i vostri commenti.