iFrame API · Bantuan Measure Map Online

Tampilkan salah satu proyek Anda sebagai peta langsung di situs web Anda sendiri, dengan satuan, gaya peta, dan tema yang sesuai dengan situs Anda.

iFrame API menempatkan peta sebuah proyek di halaman web Anda sendiri. Pengunjung melihat peta satelit beserta pengukuran Anda dan dapat bergerak di sekitarnya, tanpa akun dan tanpa meninggalkan situs Anda. Anda memilih proyeknya, satuannya, gaya petanya, dan tema warnanya.

Sebelum memulai#

Kunci API live dengan akses Peta tersemat. Lihat kunci API.
Proyek yang boleh dilihat pengunjung. Atur tingkat aksesnya ke Hanya melihat atau Publik. Proyek Pribadi tidak terbuka bagi pengunjung tanpa akun. Lihat proyek mana yang dapat disematkan.
Opsional, pembatasan situs web pada kunci, sehingga sematan hanya berfungsi di situs Anda sendiri. Lihat kunci API.

Buat kode sematan#

Pengembang > Sematkan peta membuatkan kodenya untuk Anda dengan kunci live Anda: pilih proyek, tema, satuan, jenis peta, dan ukuran, periksa Pratinjau langsung, lalu salin Kode sematan. Jika proyeknya pribadi, bagian ini memberitahukannya dan menawarkan Ubah menjadi “Hanya melihat”. Lihat dapatkan kode sematan untuk setiap langkahnya.

Sematkan peta dengan proyek yang dipilih dan pratinjau langsung

Kode ini membawa kunci Anda, sehingga tetap berfungsi sampai Anda mengganti kuncinya. Bagian ini memperingatkan Anda bila kunci dapat melakukan lebih dari Peta tersemat, karena siapa pun dapat membacanya di kode sumber halaman Anda, dan bila kunci tidak memiliki pembatasan situs web. Hanya Pratinjau langsung yang memakai token berumur pendek. Lihat kunci atau token.

Alamat sematan#

Sematan adalah <iframe> yang alamatnya diawali dengan https://app.measuremaponline.com/iframe_api, diikuti parameter berikut:

Parameter	Diperlukan	Nilai
`pid`	wajib	Pengenal proyek: bagian setelah `/p/` di alamat proyek dalam aplikasi.
`key`	`key` atau `token`	Kunci API Anda.
`token`	`key` atau `token`	Token dari server Anda (lihat di bawah).
`ms`	opsional	Satuan: `metric` atau `imperial`. Tanpa parameter ini, pengunjung di Amerika Serikat melihat satuan imperial dan yang lainnya metrik.
`maptype`	opsional	`satellite` (default), `map`, `hybrid`, atau `terrain`.
`theme`	opsional	`auto` (default: mengikuti pengaturan sistem pengunjung sendiri), `light`, atau `dark`.

Contoh minimal#

<iframe src="https://app.measuremaponline.com/iframe_api?pid=YOUR_PROJECT_ID&key=YOUR_API_KEY&maptype=satellite&theme=auto"
  title="YOUR_PROJECT_NAME" width="500" height="500" style="border:0" allow="fullscreen"></iframe>

Ganti YOUR_PROJECT_ID, YOUR_API_KEY, dan YOUR_PROJECT_NAME (pembaca layar membacakan title), lalu atur lebar dan tingginya agar sesuai dengan halaman Anda.

Kunci atau token#

Dengan key, seperti pada kode yang diberikan bagian Sematkan peta, sematan tetap berfungsi selama kuncinya berfungsi, di situs web yang diizinkan oleh pembatasannya. Kunci Anda kemudian terlihat di kode sumber halaman Anda, jadi:

gunakan kunci yang hanya memiliki akses Peta tersemat;
batasi kunci tersebut ke situs web Anda sendiri;
saat Anda mengganti kunci, perbarui halaman Anda dalam 24 jam selama kunci lama masih berfungsi.

Dengan token, kunci tetap berada di server Anda. Cara ini cocok untuk sematan yang ditulis server Anda sendiri ke halaman pada setiap kunjungan: sebelum menampilkan halaman, server meminta token ke REST API lalu menaruhnya di alamat iframe:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token, dengan kunci Anda di header Authorization, mengembalikan token yang berlaku selama 60 menit;
POST https://api.measuremaponline.com/api/v2/auth/token melakukan hal yang sama dan menerima duration dalam detik, hingga 24 jam. Jawabannya menyebutkan kapan token kedaluwarsa.

Akun Anda dapat mengambil hingga 600 token per jam. Gunakan kunci live: sematan hanya menampilkan proyek live, sehingga token yang dibuat dengan kunci sandbox tidak membuka peta. Lihat referensi API.

Apa yang dapat dilakukan pengunjung#

Pengunjung dapat menggeser dan memperbesar/memperkecil peta serta membaca pengukuran bentuk Anda. Mereka tidak dapat mengubah apa pun: pengeditan dinonaktifkan di dalam sematan, apa pun tingkat akses proyeknya. Satu-satunya pengecualian adalah proyek Open Guest pada paket Open Guest, tempat pengunjung melakukan pengukuran sendiri.

Saat peta tidak muncul#

Periksa, secara berurutan:

Alamatnya memiliki token yang sudah kedaluwarsa. Token berlaku 60 menit kecuali server Anda meminta lebih lama. Salin lagi kodenya dari Sematkan peta, yang memakai kunci Anda, atau minta server Anda mengambil token baru untuk setiap kunjungan (lihat di atas).
Proyeknya pribadi. Atur ke Hanya melihat atau Publik, atau tekan Ubah menjadi “Hanya melihat” di Sematkan peta.
Situs webnya tidak diizinkan. Jika kunci memiliki pembatasan situs web, halaman yang menampilkan sematan harus berada di salah satunya. Beberapa browser dan situs menyembunyikan halaman tempat sebuah sematan berada; jika pembatasan diatur, sematan seperti itu ditolak.
Kuncinya sudah diganti. Kunci lama berhenti 24 jam setelah kunci baru dibuat, atau seketika jika dicabut.
Kuncinya adalah kunci sandbox. Sematan hanya berfungsi dengan kunci live dan proyek live.
Langganan tidak aktif, atau akses API telah ditangguhkan: bagian Kunci API memberitahukannya.