谷歌眼镜Mirror API开发指南之Location

原文地址：http://bbs.seacat.cn/thread-884-1-2.html

位置

你可以用Google MirrorAPI在timeline item来观察用户的位置,直接请求他们最后的位置, 周期性订阅位置更新。你也可以在时间表交付预渲染地图图像卡时给Mirror API坐标

注意：需要额外在https://www.googleapis.com/auth/Glass.location检索用户的位置范围。

获取最新的已知位置

为当前用户检索最新的已知位置,给静止的端点发送一个GET请求。

Raw HTTP

GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}

订阅位置更新

类似于订阅时间表更新（subscribing totimeline updates）,您可以通过订阅订阅位置更新位置集合。

Raw HTTP

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://mapURI请求一张地图。这里有一个例子

<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地图会自动集中和放大以适应多线。

下面的例子展示了如何显示一个地图图像的最佳实践以及一些文本

<article>
<figure>
<imgsrc="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>
<divclass="text-auto-size">
<pclass="yellow">12 minutes to home</p><p>Medium traffic on Broadway</p>
</div>
</section>
</article>

注意：你在这个例子中可以省略颜色和宽度多线。地图在这种情况下呈现使用默认的颜色和宽度