| Pacote | flash.sensors |
| Classe | public class Geolocation |
| Herança | Geolocation  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
Se um dispositivo oferecer suporte a geolocation, você poderá usar essa classe para obter a localização geográfica atual do dispositivo. A localização geográfica é exibida no dispositivo na forma de coordenadas latitudinais e longitudinais (no formato padrão WGS-84). Quando o local do dispositivo é alterado, você pode receber atualizações sobre as mudanças. Se o dispositivo suportar este recurso, você será capaz de obter informações sobre a altitude, precisão, título, velocidade e tempo e hora da última mudança no local.
Suporte a perfil do AIR: Este recurso é suportado só em dispositivos móveis. Não conta com o suporte em desktops nem em dispositivos AIR for TV. Você pode testar o suporte em tempo de execução usando a propriedade Geolocation.isSupported. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Observação: para permitir a Localização geográfica no iOS, certifique-se de ter adicionado um par de chave-valor ao elemento infoAdditions no arquivo xml do aplicativo. Consulte Configurações do iOS para mais informações sobre o elemento infoAdditions.
Saiba mais
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isSupported : Boolean [estático] [somente leitura]
Se um sensor de local estiver disponível no dispositivo (verdadeiro); caso contrário, falso. | Geolocation | ||
| locationAlwaysUsePermission : Boolean
Esta propriedade determina o uso do tipo da permissão de acesso à localização geográfica. | Geolocation | ||
| muted : Boolean [somente leitura]
Especifica se o usuário tem acesso negado à localização geográfica (true) ou acesso permitido (false). | Geolocation | ||
| permissionStatus : String [estático] [somente leitura] | Geolocation | ||
| Método | Definido por | ||
|---|---|---|---|
Cria uma nova instância de Geolocation. | Geolocation | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
| Geolocation | |||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
Usado para definir o intervalo de tempo das atualizações, em milissegundos. | Geolocation | ||
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Geolocation | ||||
| O objeto Geolocation emite eventos de status quando o usuário altera o acesso ao sensor de local. | Geolocation | |||
| O evento update é despachado em resposta às atualizações do sensor de local. | Geolocation | |||
isSupported | propriedade |
locationAlwaysUsePermission | propriedade |
locationAlwaysUsePermission:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 29 |
Esta propriedade determina o uso do tipo da permissão de acesso à localização geográfica. O tipo de permissão pode ser Sempre ou Durante uso. Se a propriedade estiver definida como false, solicitará uma permissão Durante uso, caso contrário, solicitará uma permissão Sempre. Defina a propriedade antes de chamar requestPermission(). O valor padrão da propriedade é false.
Implementação
public function get locationAlwaysUsePermission():Boolean public function set locationAlwaysUsePermission(value:Boolean):void muted | propriedade |
muted:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Especifica se o usuário tem acesso negado à localização geográfica (true) ou acesso permitido (false). Quando esse valor for alterado, é despachado um evento status.
Implementação
public function get muted():BooleanElementos da API relacionados
permissionStatus | propriedade |
Geolocation | () | Construtor |
public function Geolocation()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
Cria uma nova instância de Geolocation.
requestPermission | () | método |
public function requestPermission():voidsetRequestedUpdateInterval | () | método |
public function setRequestedUpdateInterval(interval:Number):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
Usado para definir o intervalo de tempo das atualizações, em milissegundos. O intervalo de atualização só é usado como uma sugestão para economizar a bateria. A hora real entre atualizações de local pode ser maior ou menor do que este valor. Qualquer mudança no intervalo de atualização usando este método afeta todos ouvintes de evento update registrados. A classe Geolocation pode ser usada sem chamar o método setRequestedUpdateInterval. Nesta caixa, a plataforma retornará atualizações com base no seu intervalo de padrão.
Nota: os iPhones de primeira geração, que não incluem uma unidade GPS, enviam eventos upadte apenas ocasionalmente. Nestes dispositivos, um objeto Geolocation envia inicialmente um ou dois eventos update. Ele então envia eventos update quando as informações são visivelmente alteradas.
Parâmetros
interval:Number — intervalo de atualização solicitado. Se interval <= 0, então qualquer chamada a deste método não possui efeito.
|
Lança
ArgumentError — O interval especificado é menor do que zero.
|
permissionStatus | Evento |
status | Evento |
flash.events.StatusEventpropriedade StatusEvent.type =
flash.events.StatusEvent.STATUS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
O objeto Geolocation envia os eventos status quando o usuário altera o acesso ao sensor de local. Por exemplo, se, em resposta a uma solicitação de um dispositivo o usuário impedir o aplicativo de acessar dados de local, o objeto Geolcation enviará um evento status. Quando o status mudar para um estado no qual o sensor de local não esteja disponível, a propriedade muted da instância de Geolocation será true.
type de um objeto de evento status.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
code | Uma descrição do status do objeto. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
nível | A categoria da mensagem, como "status", "warning" ou "error". |
target | O objeto que está reportando o status. |
Elementos da API relacionados
update | Evento |
flash.events.GeolocationEventpropriedade GeolocationEvent.type =
flash.events.GeolocationEvent.UPDATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Lite 4 |
O evento update é despachado em resposta às atualizações do sensor de local. O evento é despachado nas seguintes circunstâncias:
- Quando uma nova função de ouvinte é anexada por
addEventListener(), este evento é entregue uma vez a todos os ouvintes registrados para fornecer o valor atual do local. Observação: o AIR despacha o primeiro evento imediatamente se o dispositivo tiver um último local conhecido. Seu código precisa estar ciente de que o evento despachado inicialmente pode não conter o local atual. - Sempre que as atualizações de local sejam obtidas da plataforma em intervalos determinados de dispositivo.
- Sempre que o aplicativo ignorar a uma mudança no local (por exemplo, o aplicativo está reiniciando depois de estar no sleep).
Nota: os iPhones de primeira geração, que não incluem uma unidade GPS, enviam eventos upadte apenas ocasionalmente. Nestes dispositivos, um objeto Geolocation envia inicialmente um ou dois eventos update. Ele então envia eventos update quando as informações são visivelmente alteradas.
type de um objeto de evento GeolocationEvent.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
target | O objeto Geolocation que está recebendo os dados. |
update de localização geográfica como eles são recebidos.
package
{
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.events.GeolocationEvent;
import flash.events.MouseEvent;
import flash.events.StatusEvent;
import flash.sensors.Geolocation;
import flash.text.TextField;
import flash.text.TextFormat;
public class GeolocationTest extends Sprite
{
private var geo:Geolocation;
private var log:TextField;
public function GeolocationTest()
{
super();
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
setUpTextField();
if (Geolocation.isSupported)
{
geo = new Geolocation();
if (!geo.muted)
{
geo.addEventListener(GeolocationEvent.UPDATE, geoUpdateHandler);
}
geo.addEventListener(StatusEvent.STATUS, geoStatusHandler);
}
else
{
log.text = "Geolocation not supported";
}
}
public function geoUpdateHandler(event:GeolocationEvent):void
{
log.text = "latitude : " + event.latitude.toString() + "\n";
log.appendText("longitude : " + event.longitude.toString() + "\n");
}
public function geoStatusHandler(event:StatusEvent):void
{
if (geo.muted)
geo.removeEventListener(GeolocationEvent.UPDATE, geoUpdateHandler);
else
geo.addEventListener(GeolocationEvent.UPDATE, geoUpdateHandler);
}
private function setUpTextField():void
{
log = new TextField();
var format:TextFormat = new TextFormat("_sans", 24);
log.defaultTextFormat = format;
log.border = true;
log.wordWrap = true;
log.multiline = true;
log.x = 10;
log.y = 10;
log.height = stage.stageHeight - 20;
log.width = stage.stageWidth - 20;
log.addEventListener(MouseEvent.CLICK, clearLog);
addChild(log);
}
private function clearLog(event:MouseEvent):void
{
log.text = "";
}
}
}
Wed Jun 13 2018, 11:10 AM Z