מיקום

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

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