مکان

شما می‌توانید از API گوگل میرور (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"
}

رندر کردن نقشه‌ها روی کارت‌های تایم‌لاین

API گوگل میرور می‌تواند نقشه‌ها را برای شما رندر کند و نشانگرها و خطوط را برای مشخص کردن مکان‌ها و مسیرهای مهم روی هم قرار دهد. از آدرس 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 یک خط قرمز به عرض ۸ پیکسل بین ( 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>

نقشه از پیش رندر شده روی کارت جدول زمانی