Konum

Google Mirror API'yi kullanarak kullanıcının konumunu zaman çizelgesi öğelerinde gözlemleyebilir, doğrudan bilinen son konumunu isteyebilir ve periyodik konum güncellemelerine abone olabilirsiniz. Ayrıca, Mirror API'ye çizilecek koordinatları vererek zaman çizelgesi kartlarında önceden oluşturulmuş harita resimleri de sunabilirsiniz.

Bilinen son konumu alma

Mevcut kullanıcının bilinen son konumunu almak 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 olmaya benzer şekilde, locations koleksiyonuna abone olarak konum güncellemelerine abone olabilirsiniz.

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 haritaları oluşturma

Google Mirror API, sizin için haritalar oluşturabilir ve önemli yerleri ve yolları belirtmek için işaretçiler ve çizgiler yerleştirebilir. Harita istemek için glass://map URI'sini kullanın. 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ı aşağıda verilmiştir:

  • w: Döndürülen harita resminin piksel cinsinden genişliği
  • h: Döndürülen harita resminin piksel cinsinden yüksekliği

Aşağıdaki listedeki öğelerden yalnızca biri ek olarak gereklidir ancak hepsini belirtebilirsiniz:

  • center ve zoom: Oluşturulacak haritanın merkezi (enlem,boylam) ve yakınlaştırma seviyesi. Daha fazla bilgi için Zoom Seviyeleri başlıklı makaleyi inceleyin.
  • marker - Belirtilen koordinatlarda çizilecek raptiye işaretçilerini belirtin. İşaretçi parametresi, işaretçi türünü (0, pin ve 1, geçerli konumu gösterir), enlem koordinatını ve boylam koordinatını alır. center ve zoom değerlerini açıkça belirtmezseniz harita, oluşturduğunuz işaretçilerin etrafında otomatik olarak ortalanır ve yakınlaştırılır.
  • polyline: Haritada bir yolu temsil etmek için çoklu çizgi koordinatlarını belirtin. Her çoklu çizgi, genişlik ve renkten sonra çoklu çizgideki köşelerden oluşur. Örneğin: 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 kırmızı bir çizgi belirtir. center ve zoom değerlerini açıkça belirtmezseniz harita, çoklu çizgiye sığacak şekilde otomatik olarak ortalanır ve yakınlaştırılır.

Aşağıdaki örnekte, harita resminin nasıl metinle birlikte gösterileceğine dair en iyi uygulama ve bu uygulamanın sonucu gösterilmektedir:

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

Zaman çizelgesi kartında önceden oluşturulmuş harita