Vị trí

Bạn có thể sử dụng Google Mirror API để theo dõi vị trí của người dùng trong các mục trên dòng thời gian, yêu cầu trực tiếp thông tin vị trí xác định gần đây nhất của họ và đăng ký nhận thông tin cập nhật vị trí định kỳ. Bạn cũng có thể phân phối hình ảnh bản đồ được kết xuất trước trong thẻ dòng thời gian bằng cách cung cấp cho Mirror API các toạ độ để vẽ.

Truy xuất vị trí đã biết gần đây nhất

Để truy xuất thông tin vị trí xác định gần đây nhất cho người dùng hiện tại, hãy gửi yêu cầu GET đến điểm cuối REST:

HTTP thô

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

Đăng ký nhận thông tin cập nhật về vị trí

Tương tự như đăng ký nhận thông tin cập nhật trên dòng thời gian, bạn có thể đăng ký nhận thông tin cập nhật về vị trí bằng cách đăng ký bộ sưu tập locations.

HTTP thô

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"
}

Kết xuất bản đồ trên thẻ dòng thời gian

Google Mirror API có thể hiển thị bản đồ cho bạn và phủ các điểm đánh dấu cũng như đường kẻ để biểu thị những địa điểm và đường đi quan trọng. Sử dụng URI glass://map để yêu cầu một bản đồ. Ví dụ:

<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"/>

Sau đây là nội dung mô tả về các tham số bắt buộc:

  • w – Chiều rộng tính bằng pixel của hình ảnh bản đồ được trả về
  • h – Chiều cao tính bằng pixel của hình ảnh bản đồ được trả về

Bạn chỉ cần cung cấp thêm một trong các mục trong danh sách sau, nhưng bạn có thể chỉ định tất cả các mục:

  • center và zoom – Tâm (vĩ độ,kinh độ) của bản đồ cần kết xuất và mức thu phóng. Hãy xem phần Các mức thu phóng để biết thêm thông tin.
  • marker – Chỉ định các điểm đánh dấu ghim để vẽ tại các toạ độ được chỉ định. Tham số điểm đánh dấu lấy một loại điểm đánh dấu (0 cho biết pin và 1, vị trí hiện tại), toạ độ vĩ độ và toạ độ kinh độ. Bản đồ sẽ tự động căn giữa và thu phóng xung quanh các điểm đánh dấu mà bạn tạo nếu bạn không chỉ định rõ center và zoom.
  • polyline – Chỉ định toạ độ của hình nhiều đường để biểu thị một đường dẫn trên bản đồ. Mỗi hình nhiều đường bao gồm một chiều rộng và màu sắc, theo sau là các đỉnh trong hình nhiều đường. Ví dụ: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 chỉ định một đường màu đỏ có chiều rộng 8 pixel giữa (47.6,-122.34) và (47.62,-122.40). Bản đồ sẽ tự động được căn giữa và thu phóng để vừa với đường nhiều đoạn nếu bạn không chỉ định rõ center và zoom.

Ví dụ sau đây minh hoạ một phương pháp hay nhất về cách hiển thị hình ảnh bản đồ cùng với một số văn bản và hình thức của hình ảnh đó:

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

bản đồ được kết xuất trước trên thẻ dòng thời gian