สถานที่

คุณสามารถใช้ 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 สามารถแสดงแผนที่ให้คุณได้ รวมถึงวางซ้อนมาร์กเกอร์และเส้นเพื่อระบุสถานที่และเส้นทางที่สำคัญ ใช้ URI glass://map เพื่อขอแผนที่ ตัวอย่าง

<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 จะระบุเส้นสีแดงกว้าง 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>

แผนที่ที่เรนเดอร์ล่วงหน้าในการ์ดไทม์ไลน์