地理位置標籤小器具
「地理位置標籤」有三種模式：
• 隱形追蹤 - 持續 (請參閱下方註記) 取得位置，而不在畫面上提供視覺化表示。
• 受控追蹤 - 能夠持續 (請參閱下方註記) 取得位置，但有一個視覺化控制項可供開啟或關閉此功能。依預設，若該控制項可見，表示追蹤為禁用狀態。使用者必須將其開啟才能進行追蹤。
• 靜態抓取 - 系統會在混搭初始化時取得一次位置，然後除非整個混搭重新載入，否則不會再次取得。在此模式下，畫面上不會有視覺化表示。
 |
「持續」與否視裝置而定。比如說，大型筆電追蹤您方位的速率要比啟用 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
|
例外
如果地理位置標籤無法取得位置，便會擲回一個錯誤。(位置失敗不會觸發 Changed 事件。)錯誤分成兩個可繫結的部份：
• ErrorCode - 一個從 0 至 3 的數字。
• ErrorMessage - 以下列方式對應於 ErrorCode：
◦ 'Permission denied' == 1：通常會在終端使用者選擇不共用其位置時傳回。
◦ 'Position unavailable' == 2：某種類型的網路失敗。
◦ 'Timeout' == 3：不會在經由 Timeout 內容指定的時間 (秒) 內透過網路獲得位置。
◦ 'Unknown error' == 0
除 ErrorMessage 和 ErrorCode 之外，系統會以錯誤發生的時間來更新 DateTime 內容。
 |
如果「地理位置標籤」配置為 TrackLocation，且 ShowControls 為開啟狀態，例外控制項將會顯示在 UI 中。您可以按一下該控制項來嘗試再次取得您的位置。
|