जगह

Google Mirror API का इस्तेमाल करके, टाइमलाइन आइटम में उपयोगकर्ता की जगह देखी जा सकती है. साथ ही, सीधे तौर पर उनकी पिछली जगह की जानकारी का अनुरोध किया जा सकता है और समय-समय पर मिलने वाले जगह के अपडेट की सदस्यता ली जा सकती है. Mirror API को ड्रॉ करने के लिए निर्देशांक देकर, टाइमलाइन कार्ड में पहले से रेंडर की गई मैप इमेज भी दिखाई जा सकती हैं.

ध्यान दें: उपयोगकर्ताओं की जगह की जानकारी पाने के लिए, अतिरिक्त https://www.googleapis.com/auth/glass.location स्कोप की ज़रूरत होती है.

डिवाइस की आखिरी जगह की जानकारी पाना

मौजूदा उपयोगकर्ता के लिए, डिवाइस की आखिरी जगह की जानकारी पाने के लिए, REST एंडपॉइंट पर अनुरोध भेजें:GET

रॉ एचटीटीपी

GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}

जगह के अपडेट की सदस्यता लेना

टाइमलाइन के अपडेट की सदस्यता लेने जैसा ही, आप locations कलेक्शन की सदस्यता लेकर, जगह के अपडेट की सदस्यता ले सकते हैं.

रॉ एचटीटीपी

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"
}

**ध्यान दें:** फ़िलहाल, जगह की सूचनाएं हर 10 मिनट में भेजी जाती हैं.

टाइमलाइन कार्ड पर मैप रेंडर करना

Google Mirror 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"/>

ध्यान दें: <img> टैग में, इमेज की चौड़ाई और ऊंचाई हमेशा तय करें. इससे मैप इमेज रेंडर होने के दौरान, रीफ़्लो नहीं होता.

यहां ज़रूरी पैरामीटर के बारे में बताया गया है:

• 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) के बीच, 8 पिक्सल चौड़ी लाल लाइन. अगर 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>

ध्यान दें: इस उदाहरण की तरह, पॉलीलाइन का रंग और चौड़ाई तय न भी की जा सकती है. इस स्थिति में, मैप को डिफ़ॉल्ट रंग और चौड़ाई का इस्तेमाल करके रेंडर किया जाता है.