位置

您可以使用 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 - 指定要在指定座標繪製的圖釘標記。 標記參數會採用標記類型 (0 表示 pin，1 表示目前位置)、緯度座標和經度座標。如果您未明確指定 center 和 zoom，地圖會自動以您建立的標記為中心並縮放。
  • polyline - 指定折線座標，在地圖上表示路徑。每條折線都包含寬度和顏色，後面接著折線中的頂點。舉例來說：polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 會在 (47.6,-122.34) 和 (47.62,-122.40) 之間指定 8 像素寬的紅線。如果未明確指定 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>

時間軸資訊卡上預先算繪的地圖