| Pakket | flash.sensors |
| Klasse | public class Geolocation |
| Overerving | Geolocation  EventDispatcher Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2, Flash Lite 4 |
Als een apparaat geolocatie ondersteunt, kunt u deze klasse gebruiken om de huidige geografische locatie van het apparaat te bepalen. De geografische locatie wordt weergegeven op het apparaat in de vorm van breedte- en lengtecoördinaten (in WGS-84-standaardformaat). Als de locatie van het apparaat wijzigt, kunt u updates over de wijzigingen ontvangen. Als het apparaat deze functie ondersteunt, kunt u informatie ontvangen over de hoogte, nauwkeurigheid, koers, snelheid en tijdstempel van de laatste wijziging in de locatie.
AIR-profielondersteuning: deze functie wordt alleen ondersteund op mobiele apparaten. Deze functie wordt niet ondersteund op het bureaublad of bij AIR for TV-apparaten. Met de eigenschap Geolocation.isSupported kunt u testen of de functie tijdens runtime wordt ondersteund. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Opmerking: als u Geolocation wilt inschakelen in iOS, moet u een sleutelwaardepaar toevoegen aan het element infoAdditions in het XML-bestand van de toepassing. Zie iOS-instellingen voor meer informatie over het element infoAdditions.
Meer informatie
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| isSupported : Boolean [statisch] [alleen-lezen]
Geeft op of een locatiesensor beschikbaar is op het apparaat (true) of niet (false). | Geolocation | ||
| locationAlwaysUsePermission : Boolean
Deze eigenschap bepaalt het gebruik van het toegangsmachtigingstype geolocation. | Geolocation | ||
| muted : Boolean [alleen-lezen]
Geeft op of de gebruiker toegang tot de geolocatie heeft geweigerd (true) of toegestaan (false). | Geolocation | ||
| permissionStatus : String [statisch] [alleen-lezen] | Geolocation | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
Hiermee wordt een nieuwe instantie Geolocation gemaakt. | Geolocation | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
| Geolocation | |||
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
Wordt gebruikt voor het instellen van het tijdsinterval van updates, in milliseconden. | Geolocation | ||
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | ||
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | ||
| Geolocation | ||||
| Het Geolocation-object verzendt status-gebeurtenissen als de gebruiker de toegang tot de locatiesensor wijzigt. | Geolocation | |||
| De update-gebeurtenis wordt verzonden als antwoord op updates van de locatiesensor. | Geolocation | |||
isSupported | eigenschap |
locationAlwaysUsePermission | eigenschap |
locationAlwaysUsePermission:Boolean| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 29 |
Deze eigenschap bepaalt het gebruik van het toegangsmachtigingstype geolocation. Het machtigingstype is 'Always' of 'When in Use' (respectievelijk Altijd of Wanneer in gebruik). Wanneer de eigenschap is ingesteld op false, wordt de machtiging 'When in Use' gevraagd. In alle andere gevallen wordt de machtiging 'Always' gevraagd. Stel de eigenschap in voordat u requestPermission() aanroept. De standaardwaarde van de eigenschap is false.
Implementatie
public function get locationAlwaysUsePermission():Boolean public function set locationAlwaysUsePermission(value:Boolean):void muted | eigenschap |
muted:Boolean [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2 |
Geeft op of de gebruiker toegang tot de geolocatie heeft geweigerd (true) of toegestaan (false). Wanneer deze waarde verandert, wordt een gebeurtenis status verzonden.
Implementatie
public function get muted():BooleanVerwante API-elementen
permissionStatus | eigenschap |
Geolocation | () | Constructor |
public function Geolocation()| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2, Flash Lite 4 |
Hiermee wordt een nieuwe instantie Geolocation gemaakt.
requestPermission | () | methode |
public function requestPermission():voidsetRequestedUpdateInterval | () | methode |
public function setRequestedUpdateInterval(interval:Number):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2, Flash Lite 4 |
Wordt gebruikt voor het instellen van het tijdsinterval van updates, in milliseconden. Het update-interval wordt alleen gebruikt als een hint om batterijvermogen te conserveren. De werkelijke tijd tussen locatie-updates kan groter of kleiner zijn dan deze waarde. Elke wijziging in het update-interval met deze methode beïnvloedt alle geregistreerde update-gebeurtenislisteners. De Geolocation-klasse kan gebruikt worden zonder oproep van de methode setRequestedUpdateInterval(). In dat geval retourneert het platform updates die gebaseerd zijn op het standaardinterval.
Opmerking: iPhones van de eerste generatie zonder GPS-eenheid versturen alleen af en toe update-gebeurtenissen. Op deze toestellen verstuurt een object Geolocation aanvankelijk een of twee update-gebeurtenissen. Vervolgens worden er update-gebeurtenissen verstuurd wanneer de gegevens aanmerkelijk veranderen.
Parameters
interval:Number — aangevraagd update-interval. Als interval <= 0 is, heeft een oproep voor deze methode geen effect.
|
Gegenereerde uitzondering
ArgumentError — Het opgegeven interval is minder dan nul.
|
permissionStatus | Gebeurtenis |
status | Gebeurtenis |
flash.events.StatusEventeigenschap StatusEvent.type =
flash.events.StatusEvent.STATUS| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2, Flash Lite 4 |
Het object Geolocation verzendt status-gebeurtenissen als de gebruiker de toegang tot de locatiesensor wijzigt. Als de gebruiker bijvoorbeeld naar aanleiding van een vraag van het apparaat verhindert dat de toepassing toegang krijgt tot locatiegegevens, wordt er een status-gebeurtenis door het object Geolocation verzonden. Als de status wordt gewijzigd naar een status waarin de locatiesensor niet beschikbaar is, wordt de eigenschap muted van de Geolocation-instantie ingesteld op true.
type van een gebeurtenisobject status.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
code | Beschrijving van de status van het object. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
level | De categorie van het bericht, zoals "status", "warning" of "error". |
target | Het object dat zijn status rapporteert. |
Verwante API-elementen
update | Gebeurtenis |
flash.events.GeolocationEventeigenschap GeolocationEvent.type =
flash.events.GeolocationEvent.UPDATE| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2, Flash Lite 4 |
De update-gebeurtenis wordt verzonden als antwoord op updates van de locatiesensor. De gebeurtenis wordt verzonden in de volgende omstandigheden:
- Wanneer een nieuwe listenerfunctie wordt gekoppeld via
addEventListener(), wordt deze gebeurtenis eenmaal aan alle geregistreerde listeners geleverd om de huidige waarde van de locatie op te geven. Opmerking: AIR verzendt de eerste gebeurtenis direct indien het apparaat beschikt over een 'laatst bekende'-locatie; uw code moet dus beseffen dat de oorspronkelijk verzonden gebeurtenis niet noodzakelijkerwijs de huidige locatie bevat. - Wanneer updates van de locatie worden verkregen via het platform op door het apparaat bepaalde intervals.
- Wanneer de toepassing een wijziging in de locatie overslaat (bijvoorbeeld wanneer de toepassing opnieuw actief wordt nadat deze in de slaapstand is geweest).
Opmerking: iPhones van de eerste generatie zonder GPS-eenheid versturen alleen af en toe update-gebeurtenissen. Op deze toestellen verstuurt een object Geolocation aanvankelijk een of twee update-gebeurtenissen. Vervolgens worden er update-gebeurtenissen verstuurd wanneer de gegevens aanmerkelijk veranderen.
type van een GeolocationEvent-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het Geolocation-object dat de gegevens ontvangt. |
update-gebeurtenissen weergegeven wanneer ze worden ontvangen.
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:42 AM Z