Guía de desarrollo

Local Navigation

Recuperar una ubicación GPS utilizando una página Web

Puede utilizar JavaScript para configurar el modo GPS y determinar la ubicación actual del dispositivo BlackBerry utilizando BlackBerry Browser.

Puede utilizar los métodos y las propiedades siguientes de JavaScript para acceder a la API de ubicación desde BlackBerry Browser.

Propiedad de JavaScript

Descripción

blackberry.location.GPSSupported

Esta propiedad devuelve true cuando el dispositivo BlackBerry es compatible con GPS.

blackberry.location.latitude

Esta propiedad devuelve la latitud actual, en grados, del dispositivo BlackBerry. Los valores positivos indican latitud Norte y los valores negativos indican latitud Sur.

blackberry.location.longitude

Esta propiedad devuelve la longitud actual, en grados, del dispositivo BlackBerry. Los valores positivos indican longitud Este y los valores negativos indican longitud Oeste

blackberry.location.timestamp

Esta propiedad devuelve la hora (en milisegundos desde el epoch) en que se actualizó el objeto blackberry.location.

Método de JavaScript

Descripción

blackberry.location.setAidMode(mode)

Este método especifica qué modo GPS utilizará el dispositivo BlackBerry para determinar la ubicación GPS. El modo puede ser cualquiera de los valores siguientes:

  • 0 para el modo de estación base
  • 1 para el modo asistido
  • 2 para el modo autónomo

blackberry.location.refreshLocation()

Este método solicita una actualización de la ubicación del dispositivo BlackBerry. Este método es asincrónico, así que la secuencia de comandos continúa aunque se haya recibido información actualizada de la ubicación. Para garantizar que la información de ubicación se actualiza antes de leerla, debe registrar en primer lugar un oyente mediante blackberry.location.onLocationUpdate() que lee blackberry.location.latitude y blackberry.location.longitude y, a continuación, llama a refreshLocation().

blackberry.location.onLocationUpdate("callback")

Este método registra un servicio de escucha que evalúa una cadena o llama a una función siempre que el dispositivo BlackBerry recibe información actualizada de la ubicación.

En los dispositivos BlackBerry que ejecuten versiones de BlackBerry Device Software anteriores a la versión 4.6, esta función debe pasarse como una cadena evaluada cada vez que se actualiza la ubicación. En dispositivos BlackBerry que ejecuten BlackBerry Device Software versión 4.6 o posterior, puede pasar una cadena o utilizar el método para registrar una función de devolución de llamada.

Una vez que se ha invocado onlocationUpdate(), la devolución de la llamada se produce siempre que hay una actualización de la información de ubicación.

Esto puede ser con tanta frecuencia como una vez cada varios segundos. Si ha pasado una función al método, puede cancelar la devolución de la llamada utilizando blackberry.removeLocationUpdate().location. Si ha pasado una cadena, la devolución de la llamada no puede eliminarse.

blackberry.location.removeLocationUpdate()

Este método elimina una función de devolución de llamada registrada anteriormente. Este método sólo lo admiten los dispositivos BlackBerry que ejecutan BlackBerryDevice Software versión 4.6 posterior.


¿Le ha resultado útil esta información? Envíenos sus comentarios.