Guia do desenvolvedor

Local Navigation

Recuperar uma localização do GPS usando uma página da Web

Você pode usar o JavaScript para configurar o modo de GPS e determinar o local atual do aparelho BlackBerry usando o BlackBerry Browser.

Você pode usar os seguintes métodos e propriedades do JavaScript para acessar a API Location a partir do BlackBerry Browser.

Propriedade do JavaScript

Descrição

blackberry.location.GPSSupported

Esta propriedade retorna true quando o aparelho BlackBerry oferece suporte a GPS.

blackberry.location.latitude

Esta propriedade retorna a latitude atual, em graus, do aparelho BlackBerry. Os valores positivos indicam latitude norte, e os valores negativos indicam latitude sul.

blackberry.location.longitude

Esta propriedade retorna a longitude atual, em graus, do aparelho BlackBerry. Os valores positivos indicam longitude leste, e os valores negativos indicam a longitude oeste

blackberry.location.timestamp

Esta propriedade retorna o horário (em milissegundos desde o início) em que o objeto blackberry.location foi atualizado.

Método JavaScript

Descrição

blackberry.location.setAidMode(mode)

Este método especifica o modo de GPS que o aparelho BlackBerry usará para determinar a localização do GPS. O modo pode ser qualquer um dos seguintes valores:

  • 0 para modo estação rádio-base
  • 1 para modo assistido
  • 2 para modo autônomo

blackberry.location.refreshLocation()

Este método solicita uma atualização do local do aparelho BlackBerry. Este método é assíncrono, portanto o script continua independentemente de terem ou não sido recebidas informações atualizadas sobre a localização. Para assegurar que as informações do local sejam atualizadas antes de sua leitura, você deve primeiro registrar um ouvinte usando blackberry.location.onLocationUpdate() que lê blackberry.location.latitude e blackberry.location.longitude, e então ligar para refreshLocation().

blackberry.location.onLocationUpdate("callback")

Este método registra um ouvinte que avalia uma string ou ativa uma função sempre que o aparelho BlackBerry recebe informações de localização atualizadas.

Em aparelhos BlackBerry que executam versões do BlackBerry Device Software anteriores à 4.6, esta função deve ser fornecida como uma string que é avaliada toda vez que a localização é atualizada. Em aparelhos BlackBerry que executam o BlackBerry Device Software versão 4.6 ou posterior, você pode fornecer uma string ou usar o método para registrar uma função de retorno de chamada.

Depois que o onlocationUpdate() for invocado, o retorno de chamada ocorrerá sempre que as informações de localização forem atualizadas.

Isto pode acontecer com grande frequência, como depois de alguns segundos. Se você tiver fornecido uma função ao método, poderá cancelar o retorno de chamada usando blackberry.location.removeLocationUpdate(). Se você tiver fornecido uma string, o retorno de chamada não poderá ser removido.

blackberry.location.removeLocationUpdate()

Este método remove uma função de retorno de chamada previamente registrada. Este método só é aceito em aparelhos BlackBerry que executam a versão 4.6 ou posterior do BlackBerry Device Software.


Estas informações foram úteis? Gostaríamos de receber seus comentários.