位置

您可以使用 Google Mirror API 在時間軸項目中觀察使用者的位置，直接要求其最後已知位置，並訂閱定期更新位置資訊。您也可提供 Mirror API 繪製的座標，以在時間軸資訊卡中提供預先轉譯的地圖圖片。

擷取最新已知位置

如要擷取目前使用者的最新已知位置，請將 GET 要求傳送至 REST 端點：

原始 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>

時間軸資訊卡上的預先轉譯地圖