GeolocationEvent

套件	flash.events
類別	public class GeolocationEvent
繼承	GeolocationEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

當 Geolocation 物件從裝置上安裝的位置感應器收到更新時，就會傳送 GeolocationEvent 物件。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		altitude : Number 高度 (以米為單位)	GeolocationEvent
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		heading : Number 移動方向 (以正北方作為基準) 整數角度。	GeolocationEvent
		horizontalAccuracy : Number 水平精確度 (以米為單位)	GeolocationEvent
		latitude : Number 緯度 (角度)。	GeolocationEvent
		longitude : Number 經度 (角度)。	GeolocationEvent
		speed : Number 速度 (以米/秒為單位)。	GeolocationEvent
		target : Object [唯讀] 事件目標。	Event
		timestamp : Number 從執行階段初始化之後，事件時間的毫秒數。	GeolocationEvent
		type : String [唯讀] 事件類型。	Event
		verticalAccuracy : Number 垂直精確度 (以米為單位)	GeolocationEvent

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		GeolocationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, latitude:Number = 0, longitude:Number = 0, altitude:Number = 0, hAccuracy:Number = 0, vAccuracy:Number = 0, speed:Number = 0, heading:Number = 0, timestamp:Number = 0) 建立包含裝置位置資訊的 GeolocationEvent 物件。	GeolocationEvent
		clone():Event [覆寫] 建立 GeolocationEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。	GeolocationEvent
		formatToString(className:String, ... arguments):String 公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。	Event
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isDefaultPrevented():Boolean 檢查是否已經對事件呼叫 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		preventDefault():void 如果可以取消事件的預設行為指令，則取消該行為指令。	Event
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stopImmediatePropagation():void 避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。	Event
		stopPropagation():void 避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。	Event
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] 傳回包含 GeolocationEvent 物件所有屬性的字串。	GeolocationEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		UPDATE : String = "update" [靜態] 定義 GeolocationEvent 事件物件的 type 屬性值。	GeolocationEvent

屬性詳細資訊

altitude

屬性

altitude:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

高度 (以米為單位)

如果裝置不支援高度，則此屬性會設定成 NaN。

實作
public function get altitude():Number
public function set altitude(value:Number):void

heading

屬性

heading:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

移動方向 (以正北方作為基準) 整數角度。這與「方向 (bearing)」不相同，它會傳回以另一個點為基準的移動方向。

注意：在 Android 裝置上，不支援航向。heading 屬性的值永遠為 NaN (非數字)。

實作
public function get heading():Number
public function set heading(value:Number):void

horizontalAccuracy

屬性

horizontalAccuracy:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

水平精確度 (以米為單位)

實作
public function get horizontalAccuracy():Number
public function set horizontalAccuracy(value:Number):void

latitude

屬性

latitude:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

緯度 (角度)。緯度值的範圍如下：(-90 <= latitude <= 90)。負值的緯度是「南方」而正值是「北方」。

實作
public function get latitude():Number
public function set latitude(value:Number):void

longitude

屬性

longitude:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

經度 (角度)。經度值的範圍如下：(-180 <= longitude < 180)。負值的經度是「西方」而正值是「東方」。

實作
public function get longitude():Number
public function set longitude(value:Number):void

speed

屬性

speed:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

速度 (以米/秒為單位)。

實作
public function get speed():Number
public function set speed(value:Number):void

timestamp

屬性

timestamp:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

從執行階段初始化之後，事件時間的毫秒數。例如，如果裝置在應用程式初始化後擷取 4 秒的地理位置資料，則事件的時間戳記屬性設定為 4000。

實作
public function get timestamp():Number
public function set timestamp(value:Number):void

verticalAccuracy

屬性

verticalAccuracy:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

垂直精確度 (以米為單位)

實作
public function get verticalAccuracy():Number
public function set verticalAccuracy(value:Number):void

建構函式詳細資料

()

建構函式

public function GeolocationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, latitude:Number = 0, longitude:Number = 0, altitude:Number = 0, hAccuracy:Number = 0, vAccuracy:Number = 0, speed:Number = 0, heading:Number = 0, timestamp:Number = 0)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

建立包含裝置位置資訊的 GeolocationEvent 物件。Event 物件會當做參數傳遞至事件偵聽程式。

參數

	`type:String` — 指定事件的類型。事件偵聽程式可以透過繼承的 `type` 屬性來存取此資訊。更新事件只有一種類型：`GeolocationEvent.UPDATE`。

	`bubbles:Boolean` (default = `false`) — 指出事件是否為反昇事件。事件偵聽程式可以透過繼承的 `bubbles` 屬性來存取此資訊。

	`cancelable:Boolean` (default = `false`) — 判斷是否可以取消 Event 物件。事件偵聽程式可以透過繼承的 `cancelable` 屬性來存取此資訊。

	`latitude:Number` (default = `0`) — 傳回緯度 (角度)。值的範圍如下：(-90 <= Lat <= +90)。

	`longitude:Number` (default = `0`) — 傳回經度 (角度)。值的範圍如下：(-180 <= Long < +180)。

	`altitude:Number` (default = `0`) — 傳回高度 (以米為單位)

	`hAccuracy:Number` (default = `0`) — 傳回水平精確度 (以米為單位)

	`vAccuracy:Number` (default = `0`) — 傳回垂直精確度 (以米為單位)。

	`speed:Number` (default = `0`) — 傳回速度 (以米/秒為單位)。

	`heading:Number` (default = `0`) — 傳回移動方向 (以正北方作為基準) 整數角度。

	`timestamp:Number` (default = `0`) — 指定 geolocation 更新的時間戳記。

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2

建立 GeolocationEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。

傳回值

Event — 新的 GeolocationEvent 物件，其屬性值符合原始物件的屬性值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2

傳回包含 GeolocationEvent 物件所有屬性的字串。此字串的格式如下：

[GeolocationEvent type=value bubbles=value cancelable=value status=value]

傳回值

String — 包含 GeolocationEvent 物件所有屬性的字串。

常數詳細資訊

UPDATE

常數

public static const UPDATE:String = "update"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2, Flash Lite 4

定義 GeolocationEvent 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	接收資料的 Geolocation 物件。

法律聲明 | 線上隱私權政策

GeolocationEvent - AS3

套件x

語言元素

附錄

套件 flash.events

altitude

heading

horizontalAccuracy

latitude

longitude

speed

timestamp

verticalAccuracy