תוכלו להשתמש ב-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>