الموقع الجغرافي

يمكنك استخدام Google Mirror API لمراقبة موقع المستخدم في عناصر المخطط الزمني وطلب آخر موقع جغرافي معروف له مباشرةً والاشتراك في خدمة تلقّي آخر الأخبار الدورية عن الموقع الجغرافي. يمكنك أيضًا عرض صور الخرائط التي تم عرضها مسبقًا في بطاقات المخطط الزمني من خلال تزويد Mirror API بالإحداثيات لرسمها.

استرداد آخر موقع جغرافي معروف

لاسترداد آخر موقع جغرافي معروف للمستخدم الحالي، أرسِل طلب `GET` إلى نقطة نهاية REST:GET

بروتوكول 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>

خريطة مُسبقة العرض على بطاقة &quot;المخطط الزمني&quot;