Location

Anda dapat menggunakan Google Mirror API untuk mengamati lokasi pengguna dalam item linimasa, meminta lokasi terakhir yang diketahui secara langsung, dan berlangganan update lokasi berkala. Anda juga dapat mengirimkan gambar peta yang telah dirender sebelumnya di kartu linimasa dengan memberikan koordinat kepada Mirror API untuk digambar.

Mengambil lokasi terbaru yang diketahui

Untuk mengambil lokasi terbaru yang diketahui untuk pengguna saat ini, kirim permintaan GET ke endpoint REST:

HTTP mentah

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

Berlangganan update lokasi

Serupa dengan berlangganan update linimasa, Anda dapat berlangganan update lokasi dengan berlangganan koleksi locations.

HTTP mentah

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

Merender peta di kartu linimasa

Google Mirror API dapat merender peta untuk Anda dan menempatkan penanda serta garis untuk menunjukkan tempat dan jalur penting. Gunakan URI glass://map untuk meminta peta. Berikut contohnya:

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

Berikut deskripsi parameter yang diperlukan:

  • w - Lebar dalam piksel gambar peta yang ditampilkan
  • h - Tinggi dalam piksel gambar peta yang ditampilkan

Hanya salah satu item dalam daftar berikut yang diperlukan, tetapi Anda dapat menentukan semuanya:

  • center dan zoom - Pusat (lintang,bujur) peta yang akan dirender pada dan tingkat zoom. Lihat Tingkat Zoom untuk mengetahui informasi selengkapnya.
  • marker - Tentukan penanda pin yang akan digambar pada koordinat yang ditentukan. Parameter penanda menggunakan jenis penanda (0 menunjukkan pin dan 1, lokasi saat ini), koordinat lintang, dan koordinat bujur. Peta akan otomatis berpusat dan melakukan zoom di sekitar penanda yang Anda buat jika Anda tidak menentukan center dan zoom secara eksplisit.
  • polyline - Tentukan koordinat polyline untuk menunjukkan jalur di peta. Setiap polyline terdiri dari lebar dan warna yang diikuti oleh verteks dalam polyline. Misalnya: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 menentukan garis merah selebar 8 piksel antara (47.6,-122.34) dan (47.62,-122.40). Peta akan otomatis berpusat dan melakukan zoom agar sesuai dengan polyline jika Anda tidak menentukan center dan zoom secara eksplisit.

Contoh berikut menunjukkan praktik terbaik cara menampilkan gambar peta dengan beberapa teks dan tampilannya:

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

peta yang telah dirender sebelumnya di kartu linimasa