您可以使用 Google Mirror API 来 观察时间轴项中的用户位置、直接请求其 最近一次的已知位置，以及 订阅定期位置更新。您还可以通过向 Mirror API 提供要绘制的坐标，在时间轴卡片中提供预渲染的地图图片。
检索最近一次的已知位置
如需检索当前用户的最近一次的已知位置，请向 REST 端点发送 GET 请求：
原始 HTTP
GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}
订阅位置更新
与订阅时间轴更新类似，
您可以通过订阅 locations
集合来订阅位置更新。
原始 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"
}
在时间轴卡片上渲染地图
Google Mirror API 可以为您渲染地图，并叠加标记和线条来表示重要地点和路径。使用 glass://map URI 请求地图。示例如下：
<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"/>
以下是必需参数的说明：
w- 返回的地图图片的宽度（以像素为单位）h- 返回的地图图片的高度（以像素为单位）
以下列表中的项只需要一个，但您可以指定所有项：
center和zoom- 要渲染的地图的中心（纬度、经度） 和缩放级别。如需了解详情，请参阅缩放级别 。marker- 指定要在指定坐标处绘制的图钉标记。 marker 参数采用标记类型（0表示pin，1表示当前位置）、纬度坐标和经度坐标。如果您未明确指定center和zoom，地图会自动以您创建的标记为中心并进行缩放。polyline- 指定多段线坐标以表示地图上的路径。 每条多段线都包含宽度和颜色，后跟多段线中的顶点。例如：polyline=8,ffff0000;47.6,-122.34,47.62,-122.40指定一条宽度为 8 像素的红线，位于 (47.6,-122.34) 和 (47.62,-122.40) 之间。 如果您未明确指定center和zoom，地图会自动以多段线为中心并进行缩放以适应多段线。
以下示例展示了如何显示包含一些文本的地图图片以及显示效果的最佳实践：
<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>
