คุณสามารถใช้ Google Mirror API เพื่อสังเกตตําแหน่งของผู้ใช้ในรายการไทม์ไลน์ ขอตําแหน่งที่รู้จักล่าสุดโดยตรง และสมัครรับข้อมูลอัปเดตตําแหน่งเป็นระยะๆ นอกจากนี้คุณยังส่งรูปภาพแผนที่แสดงผลล่วงหน้าในการ์ดไทม์ไลน์ได้ โดยให้พิกัด มิเรอร์ 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>