מיקום

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

מפה שעברה עיבוד מראש על כרטיס ציר זמן