Konum

Google Mirror API'yi kullanarak kullanıcının konumunu zaman çizelgesi öğelerinde gözlemleyebilir, bilinen son konumu doğrudan seçip abone olabilirsiniz anlık konum güncellemeleri alabilirsiniz. Önceden oluşturulmuş harita resimlerini de yayınlayabilirsiniz. Mirror API'sine çizilecek koordinatları vererek zaman çizelgesi kartlarında görüntüleyebilirsiniz.

Bilinen en son konum alınıyor

Bu kullanıcının bilinen en son konumunu almak için: geçerli kullanıcı için REST uç noktasına bir GET isteği gönderin:

Ham HTTP

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

Konum güncellemelerine abone olma

Zaman çizelgesi güncellemelerine abone olma işlemine benzer şekilde, locations için abone olarak konum güncellemelerine abone olabilirsiniz koleksiyonudur.

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

Zaman çizelgesi kartlarında harita oluşturma

Google Mirror API'si sizin için haritaları oluşturabilir ve işaretçiler ve çizgiler kullanarak önemli yerleri ve yolları gösterir. İstekte bulunmak için glass://map URI'sını kullanın bir haritadır. Aşağıda bununla ilgili bir örnek verilmiştir:

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

Gerekli parametrelerin açıklamasını aşağıda bulabilirsiniz:

  • w - Döndürülen harita görüntüsünün piksel cinsinden genişliği
  • h - Döndürülen harita görüntüsünün piksel cinsinden yüksekliği

Ayrıca, aşağıdaki listede bulunan öğelerden yalnızca biri gereklidir. Ancak hepsini belirtebilirsiniz:

  • center ve zoom - Oluşturulacak haritanın merkezi (enlem,boylam) yakınlaştırma seviyesinde olabilir. Yakınlaştırma Seviyeleri'ni inceleyin. konulu videomuzu izleyin.
  • marker - Belirtilen koordinatlarda çizilecek raptiye işaretçilerini belirtin. İşaretçi parametresi bir işaretçi türü alır (0, pin olduğunu gösterir 1, geçerli konum), enlem koordinatı ve boylam koordinatı. Harita, oluşturduğunuz işaretçileri otomatik olarak ortalar ve yakınlaştırır center ve zoom öğelerini açıkça belirtmezseniz.
  • polyline - Haritada bir yolu temsil edecek çoklu çizgi koordinatlarını belirtin. Her bir çoklu çizgi, bir genişlik ve renk ve bunu takip eden bir köşelerini çizin. Örnek: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 (47.6,-122.34) ile (47.62,-122.40) arasında 8 piksel genişliğinde bir kırmızı çizgi belirtir. Çoklu çizgiye sığdırmazsanız harita otomatik olarak ortalanır ve yakınlaştırılır. center ve zoom değerlerini açıkça belirtiyor.

Aşağıdaki örnekte, bir haritanın nasıl görüntüleneceğine dair en iyi uygulama gösterilmektedir bir resim ile nasıl göründüğüne bakın:

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

bir zaman çizelgesi kartında önceden oluşturulmuş harita