地理标记小组件
地理标记有三种模式：
• 隐形跟踪 - 持续 (请参阅以下注解) 获取某一位置，而屏幕上没有可视表示。
• 受控跟踪 - 能够持续 (请参阅以下注解) 获取某一位置，但屏幕上有用于打开或关闭此功能的可视控件。默认情况下，控制可见，即表示禁用跟踪。用户必须将其打开才能开始跟踪。
• 静态抓取 - 会在混搭初始化时获取一次位置，但之后除非重新加载整个混搭，否则都不会再次获取位置。在此模式下，屏幕上没有可视表示。
 |
“连续”取决于设备。例如，固定笔记本跟踪位置的速率要比启用 GPS 的智能手机慢很多。
|
|
|
下表不包括样式和常用的小组件属性。
|
|
属性名称
|
说明
|
基本类型
|
默认值
|
是否可绑定?(Y/N)
|
是否可本地化?(Y/N)
|
|---|---|---|---|---|---|
|
TrackLocation
|
小组件会跟踪您位置的移动。如果未设置 ShowControls，小组件会在混搭处于活动期间持续跟踪。可通过显示控件来开启/关闭跟踪。绑定到此项，会通知其他小组件进行位置跟踪。
|
BOOLEAN
|
不可用
|
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
|
不可用
|
Y
|
N
|
|
日期时间
|
检测到当前位置或返回错误的日期和时间。
|
DATETIME
|
不可用
|
Y
|
N
|
|
ShowDataLoading
|
加载时显示数据。
|
BOOLEAN
|
True
|
N
|
N
|
|
标题
|
检测到当前位置时的罗盘指向 (自正北的顺时针角度)。仅当 TrackLocation 为真时相关。
|
NUMBER
|
不可用
|
Y
|
N
|
|
Speed
|
检测到当前位置时您的移动速度 (米/秒)。仅当 TrackLocation 为真时相关。
|
NUMBER
|
不可用
|
Y
|
N
|
|
ShowControls
|
如果正在跟踪位置，您可以显示一个运行时控件以开始/停止跟踪。
|
BOOLEAN
|
False
|
N
|
N
|
|
LocationAccuracy
|
您所在位置的精度 (以米为单位)。
|
NUMBER
|
不可用
|
Y
|
N
|
|
ErrorMessage
|
获取位置失败时返回的错误消息。
|
STRING
|
不可用
|
Y
|
N
|
|
ErrorCode
|
获取位置失败时返回的错误代码。
|
NUMBER
|
不可用
|
Y
|
N
|
|
ShowDataLoading
|
允许正在加载的数据可见。
|
BOOLEAN
|
True
|
N
|
N
|
|
已更改
|
事件。获取位置成功时，会触发已更改事件。此事件可用于执行 AddStreamEntry 之类的服务以记录更新后的 CurrentLocation。
|
不可用
|
不可用
|
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 中显示例外控件。您可以单击此控件，尝试重新获取您所在的位置。
|