位置
你可以用Google Mirror API在timeline item来观察用户的位置,直接请求他们最后的位置, 周期性订阅位置更新。你也可以在时间表交付预渲染地图图像卡时给Mirror API坐标
注意:需要额外在https://www.googleapis.com/auth/Glass.location检索用户的位置范围。
获取最新的已知位置
为当前用户检索最新的已知位置,给静止的端点发送一个GET请求。
Raw HTTP
[Java] 纯文本查看 复制代码
?
01
02
GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}
订阅位置更新
类似于订阅时间表更新(subscribing to timeline updates),您可以通过订阅订阅位置更新位置集合。
Raw HTTP
[HTML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
08
09
10
11
POST /mirror/v1/subscriptions HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}
{
"collection": "locations",
"userToken": "harold_penguin",
"verifyToken": "random_hash_to_verify_referer",
"callbackUrl": "https://example.com/notify/callback"
}
注意:这时,地点通知每10分钟发送一次
呈现地图时间卡
Google Mirror API可以为您呈现地图和覆盖标记以及线条来表示重要的地方和路径。使用glass://map URI请求一张地图。这里有一个例子
[XML] 纯文本查看 复制代码
?
01
02
03
<img src="glass://map?w=width&h=height&marker=0;latitude,longitude&marker=1;latitude,longitude&polyline=;latitude,longitude,latitude,longitude"
width="width"
height="height"/>
注意:在< img >标记始终指定图像的宽度和高度。这样可以防止地图已经被释放回收
下面是必需的参数的描述:
w -返回地图图像的像素宽度
h -返回地图图像的像素的高度
下面的列表只有一项是需要另外的要求,但您可以指定它们。
1.center 和zoom --地图的中心(纬度、经度)来呈现和缩放级别。有关更多信息,请参见缩放级别(Zoom Levels)。
2. marker-- 指定标记画在指定的坐标. 标记参数需要标记类型(pin和1 和0表示,当前位置),当前经度,当前纬度。地图自动中心和缩放在您创建的标记,如果你不特别地指定中心和变焦
3. polyline - -指定在地图上的道路代表的polyline 坐标。每个polyline 由一个宽度和颜色polyline 的顶点。比如:polyline=8,ffff0000;47.6,-122.34,47.62,-122.40表示在(47.6,-122.34) 和 (47.62,-122.40)之间指定一个8-pixel宽的红线
如果没有特别的指定center和zoom地图会自动集中和放大以适应多线。
下面的例子展示了如何显示一个地图图像的最佳实践以及一些文本
[XML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
<article>
<figure>
<img src="glass://map?w=240&h=360&marker=0;42.369590,
-71.107132&marker=1;42.36254,-71.08726&polyline=;42.36254,
-71.08726,42.36297,-71.09364,42.36579,-71.09208,42.3697,
-71.102,42.37105,-71.10104,42.37067,-71.1001,42.36561,
-71.10406,42.36838,-71.10878,42.36968,-71.10703"
height="360" width="240">
</figure>
<section>
<div class="text-auto-size">
<p class="yellow">12 minutes to home</p><p>Medium traffic on Broadway</p>
</div>
</section>
</article>
注意:你在这个例子中可以省略颜色和宽度多线。地图在这种情况下呈现使用默认的颜色和宽度