| Pacchetto | flash.sensors |
| Classe | public class Geolocation |
| Ereditarietà | Geolocation  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Lite 4 |
Se un dispositivo supporta la localizzazione geografica, potete utilizzare questa classe per ottenere l'attuale posizione geografica del dispositivo. La posizione geografica viene visualizzata sul dispositivo sotto forma di coordinate latitudinali/longitudinali (nel formato standard WGS-84). Quando la posizione del dispositivo cambia, potete ricevere aggiornamenti relativi alle modifiche. Se il dispositivo supporta questa funzione, potete ottenere informazioni su altitudine, precisione, direzione, velocità e indicatore orario relative all'ultimo cambiamento di posizione.
Supporto profili AIR: questa funzionalità è supportata solo nei dispositivi mobili. Non è supportata nei dispositivi AIR per TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà Geolocation.isSupported. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Nota: per attivare Geolocation in iOS, aggiungete una coppia chiave-valore all’elemento infoAdditions nel file XML dell'applicazione. Consultate Impostazioni di iOS per ulteriori informazioni sull'elemento infoAdditions.
Altri esempi
Altre informazioni
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
Se sul dispositivo è disponibile un sensore di posizione (true). In caso contrario false. | Geolocation | ||
| locationAlwaysUsePermission : Boolean
Questa proprietà determina l'uso del tipo di autorizzazione di accesso di localizzazione geografica. | Geolocation | ||
| muted : Boolean [sola lettura]
Specifica se l'utente ha negato (true) o consentito (false) l'accesso alla funzione di localizzazione geografica. | Geolocation | ||
| permissionStatus : String [statico] [sola lettura] | Geolocation | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea una nuova istanza Geolocation. | Geolocation | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
| Geolocation | |||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
Utilizzato per impostare l'intervallo di tempo per gli aggiornamenti, in millisecondi. | Geolocation | ||
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Geolocation | ||||
| L'oggetto Geolocation invia eventi di stato quando l'utente commuta l'accesso sul sensore di posizione. | Geolocation | |||
| L'evento update viene inviato in risposta agli aggiornamenti del sensore di posizione. | Geolocation | |||
isSupported | proprietà |
locationAlwaysUsePermission | proprietà |
locationAlwaysUsePermission:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 29 |
Questa proprietà determina l'uso del tipo di autorizzazione di accesso di localizzazione geografica. Il tipo di autorizzazione può essere Sempre o Quando in uso. Se la proprietà è impostata su false, richiede l'autorizzazione Quando in uso, altrimenti quella Sempre. Impostare la proprietà prima di chiamare requestPermission(). Il valore predefinito della proprietà è false.
Implementazione
public function get locationAlwaysUsePermission():Boolean public function set locationAlwaysUsePermission(value:Boolean):void muted | proprietà |
muted:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Specifica se l'utente ha negato (true) o consentito (false) l'accesso alla funzione di localizzazione geografica. Quando questo valore cambia viene inviato un evento status.
Implementazione
public function get muted():BooleanElementi API correlati
permissionStatus | proprietà |
Geolocation | () | Funzione di costruzione |
public function Geolocation()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Lite 4 |
Crea una nuova istanza Geolocation.
requestPermission | () | metodo |
public function requestPermission():voidsetRequestedUpdateInterval | () | metodo |
public function setRequestedUpdateInterval(interval:Number):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Lite 4 |
Utilizzato per impostare l'intervallo di tempo per gli aggiornamenti, in millisecondi. L'intervallo di tempo viene utilizzato solo come suggerimento per risparmiare la carica della batteria. Il tempo effettivo tra gli aggiornamenti di posizione può essere maggiore o minore di questo valore. Qualsiasi modifica dell'intervallo di aggiornamento tramite questo metodo interessa tutti i listener di eventi update registrati. La classe Geolocation può essere utilizzata senza chiamare il metodo setRequestedUpdateInterval(). In questo caso, la piattaforma restituirà gli aggiornamenti in base al proprio intervallo predefinito.
Nota: gli iPhone di prima generazione, che sono sprovvisti di unità GPS, inviano eventi update solo occasionalmente. In questi dispositivi, un oggetto Geolocation inizialmente invia uno o due due eventi update, quindi invia altri eventi update quando le informazioni cambiano in modo significativo.
Parametri
interval:Number — Intervallo di aggiornamento richiesto. Se interval <= 0, tutte le chiamate a questo metodo non avranno effetto.
|
Genera
ArgumentError — Il parametro interval specificato è minore di zero.
|
permissionStatus | Evento |
status | Evento |
flash.events.StatusEventproprietà StatusEvent.type =
flash.events.StatusEvent.STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Lite 4 |
L'oggetto Geolocation invia eventi status quando l'utente commuta l'accesso sul sensore di posizione. Ad esempio, se in risposta a un prompt del dispositivo l'utente non autorizza l'applicazione ad accedere ai dati di posizione, l'oggetto Geolocation invia un evento status. Quando viene attivato uno stato in cui il sensore di posizione non è disponibile, la proprietà muted dell'istanza Geolocation è true.
type di un oggetto evento status.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
code | Una descrizione dello stato dell'oggetto. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
level | La categoria del messaggio, ad esempio "status", "warning" o "error". |
target | L'oggetto che riporta il proprio stato. |
Elementi API correlati
update | Evento |
flash.events.GeolocationEventproprietà GeolocationEvent.type =
flash.events.GeolocationEvent.UPDATE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Lite 4 |
L'evento update viene inviato in risposta agli aggiornamenti del sensore di posizione. L'evento viene inviato nelle seguenti circostanze:
- Quando viene associata una nuova funzione listener tramite
addEventListener(), questo evento viene inviato una volta a tutti i listener registrati per fornire il valore corrente della posizione. Nota: AIR invia il primo evento immediatamente se per il dispositivo è disponibile l’ultima posizione nota; il vostro codice deve prevedere che l’evento inviato inizialmente potrebbe non contenere la posizione corrente. - Ogni volta che, a intervalli determinati dal dispositivo, vengono ottenuti aggiornamenti della posizione dalla piattaforma.
- Ogni volta che l'applicazione non rileva una modifica nella posizione, ad esempio al ripristino dell'applicazione dopo una sospensione.
Nota: gli iPhone di prima generazione, che sono sprovvisti di unità GPS, inviano eventi update solo occasionalmente. In questi dispositivi, un oggetto Geolocation inizialmente invia uno o due due eventi update, quindi invia altri eventi update quando le informazioni cambiano in modo significativo.
type di un oggetto evento GeolocationEvent.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
target | L'oggetto Geolocation che riceve i dati. |
update non appena vengono ricevuti.
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 = "";
}
}
}
Tue Jun 12 2018, 02:44 PM Z