Location

Anda dapat menggunakan Google Mirror API untuk mengamati lokasi pengguna di item linimasa, meminta lokasi terakhir yang diketahui secara langsung, dan berlangganan hingga pembaruan lokasi berkala. Anda juga dapat mengirim gambar peta yang telah dipra-render di kartu linimasa dengan memberi Mirror API koordinat yang akan digambar.

Mengambil lokasi terakhir yang diketahui

Untuk mengambil lokasi terakhir 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 pembaruan lokasi

Mirip dengan berlangganan pembaruan linimasa, Anda dapat berlangganan pembaruan lokasi dengan berlangganan locations pengumpulan data.

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 pada kartu linimasa

Google Mirror API bisa merender peta untuk Anda serta menempatkan penanda dan garis ke menandakan 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 adalah deskripsi parameter yang diperlukan:

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

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

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

Contoh berikut menunjukkan praktik terbaik tentang cara menampilkan peta gambar dengan beberapa teks dan bagaimana 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 pra-render pada kartu linimasa