|
「持續」與否視裝置而定。比如說,大型筆電追蹤您方位的速率要比啟用 GPS 的智慧型手機慢得多。
|
|
下表不包括樣式和通用小器具內容。
|
屬性名稱
|
描述
|
基礎類型
|
預設值
|
可繫結?(Y/N)
|
可當地語系化?(Y/N)
|
---|---|---|---|---|---|
TrackLocation
|
小器具將會追蹤您位置的移動。如果不使用 ShowControls,只要使用混搭,小器具便會持續追蹤。顯示控制項可讓您可開啟/關閉追蹤。繫結至此項可通知其他小器具正在追蹤位置。
|
BOOLEAN
|
n/a
|
Y
|
N
|
EnableHighAccuracy
|
智慧型手機之類的裝置能夠使用其 GPS 功能。啟用高準確度會僅在網路能力範圍內使用 GPS 功能。啟用高準確度會影響效能,並由裝置權限管理。
|
BOOLEAN
|
True
|
Y
|
N
|
MinimumUpdateFrequency
|
小器具每次嘗試更新位置值之間的最短時間 (秒)。
|
NUMBER
|
5
|
N
|
N
|
Timeout
|
小器具會等待位置的時間 (秒)。
|
NUMBER
|
T
|
T
|
|
MaximumCacheAge
|
所快取位置的保留時間 (秒)。MaximumCacheAge 內的後續位置呼叫將傳回快取位置值。
|
NUMBER
|
0
|
N
|
N
|
CurrentLocation
|
目前位置 - WGS84 中的經度、緯度、海拔與單位。
|
LOCATION
|
n/a
|
Y
|
N
|
DateTime
|
偵測到目前位置或錯誤傳回的日期與時間。
|
DATETIME
|
n/a
|
Y
|
N
|
ShowDataLoading
|
載入時顯示資料。
|
BOOLEAN
|
True
|
N
|
N
|
Heading
|
偵測到目前位置時的羅盤航向 (從正北方向開始順時針測量的度數)。僅在 TrackLocation 為 true 時相關。
|
NUMBER
|
n/a
|
Y
|
N
|
Speed
|
偵測到目前位置時,您移動的速度 (公尺/秒)。僅在 TrackLocation 為 true 時相關。
|
NUMBER
|
n/a
|
Y
|
N
|
ShowControls
|
如果追蹤您的位置,可以顯示執行時間控制項來開始/停止追蹤。
|
BOOLEAN
|
False
|
N
|
N
|
LocationAccuracy
|
您位置的準確度 (以公尺為單位測量)。
|
NUMBER
|
n/a
|
Y
|
N
|
ErrorMessage
|
取得位置失敗時傳回的錯誤訊息。
|
STRING
|
n/a
|
Y
|
N
|
ErrorCode
|
取得位置失敗時傳回的錯誤碼。
|
NUMBER
|
n/a
|
Y
|
N
|
ShowDataLoading
|
允許讓載入中的資料可見。
|
BOOLEAN
|
True
|
N
|
N
|
Changed
|
事件。成功取得位置時,即會觸發「已變更」事件。此事件可用來執行諸如 AddStreamEntry 之類的服務,以便記錄更新後的 CurrentLocation。
|
n/a
|
n/a
|
Y
|
N
|
Visible
|
小器具在執行時間是否可見?
|
BOOLEAN
|
True
|
N
|
N
|
|
如果「地理位置標籤」配置為 TrackLocation,且 ShowControls 為開啟狀態,例外控制項將會顯示在 UI 中。您可以按一下該控制項來嘗試再次取得您的位置。
|