iFrame API · Measure Map Online Yardım

Projelerinizden birini, sitenize uygun birimlerde, harita stilinde ve temada, kendi web sitenizde canlı harita olarak gösterin.

iFrame API, bir projenin haritasını kendi web sayfanıza koyar. Ziyaretçiler, ölçümlerinizle birlikte uydu haritasını görür ve hesapsız, sitenizden ayrılmadan harita üzerinde gezinebilir. Projeyi, birimleri, harita stilini ve renk temasını siz seçersiniz.

Başlamadan önce#

Canlı bir API anahtarı, Gömülü haritalar erişimiyle. Bkz. API anahtarları.
Ziyaretçilerin görebileceği bir proje: sizin ya da başka bir hesabın, Sadece görüntüleme ya da Herkese açık olarak paylaşılmış. Özel bir proje yalnızca başka bir hesaba aitse ve sahibi sizi yetkilendirmişse görünür (bkz. müşterilerin özel projeleri); kendi özel projeleriniz hiçbir zaman görünmez. Bkz. hangi projeler yerleştirilebilir.
İsteğe bağlı olarak anahtarda web sitesi kısıtlamaları, böylece yerleştirme yalnızca kendi sitelerinizde çalışır. Bkz. API anahtarları.

Yerleştirme kodunu oluşturun#

Geliştirici > Harita göm bölümü, kodu sizin için canlı anahtarınızla oluşturur: projeyi seçin, temayı, birimleri, harita türünü ve boyutu belirleyin, Canlı önizleme önizlemesini kontrol edin ve Gömme kodu kodunu kopyalayın. Proje özelse bölüm bunu söyler ve Sadece görüntüleme yap düğmesini sunar. Her adım için bkz. yerleştirme kodunu alın.

Bir proje seçilmiş ve canlı önizlemesi olan harita yerleştirme bölümü

Kod anahtarınızı taşır; bu yüzden anahtarı değiştirene kadar çalışmaya devam eder. Anahtar Gömülü haritalar erişiminden fazlasını yapabiliyorsa (çünkü herkes sayfanızın kaynağından okuyabilir) ve anahtarın web sitesi kısıtlaması yoksa bölüm sizi uyarır. Yalnızca Canlı önizleme kısa ömürlü bir token kullanır. Bkz. anahtar ya da token.

Yerleştirme adresi#

Yerleştirme, adresi https://app.measuremaponline.com/iframe_api ile başlayan ve ardından şu parametreleri taşıyan bir <iframe> öğesidir:

Parametre	Gerekli mi	Değerler
`pid`	zorunlu	Projenin kimliği: uygulamadaki proje adresinde `/p/` sonrasındaki kısım. Sahibi bunu projenin genel bakışının sonunda kopyalayabilir; yerleşik haritada projenin adına tıklamak da kopyalar.
`key`	`key` ya da `token`	API anahtarınız.
`token`	`key` ya da `token`	Sunucunuzdan alınan bir token (aşağıya bakın).
`ms`	isteğe bağlı	Birimler: `metric` ya da `imperial`. Belirtilmezse Amerika Birleşik Devletleri'ndeki ziyaretçiler imperial, diğer herkes metrik birimleri görür.
`maptype`	isteğe bağlı	`satellite` (varsayılan), `map`, `hybrid` ya da `terrain`.
`theme`	isteğe bağlı	`auto` (varsayılan: ziyaretçinin kendi sistem ayarını izler), `light` ya da `dark`.

En küçük örnek#

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

YOUR_PROJECT_ID, YOUR_API_KEY ve YOUR_PROJECT_NAME değerlerini değiştirin (ekran okuyucular title değerini sesli okur) ve genişliği ile yüksekliği sayfanıza uyacak şekilde ayarlayın.

Kopyalama düğmesiyle birlikte yerleştirme kodu

Anahtar ya da token#

key ile, yani Harita göm bölümünün verdiği kodda olduğu gibi, yerleştirme anahtar çalıştığı sürece, kısıtlamalarının izin verdiği web sitelerinde çalışmaya devam eder. Bu durumda anahtarınız sayfanızın kaynağında görünür; bu yüzden:

yalnızca Gömülü haritalar erişimi olan bir anahtar kullanın;
onu kendi web sitelerinizle sınırlayın;
anahtarı değiştirdiğinizde, eski anahtarın çalışmaya devam ettiği 24 saat içinde sayfalarınızı güncelleyin (erişim ayarlarından önce oluşturulmuş bir anahtar, size verilen tarihe kadar çalışır).

token ile anahtar sunucunuzda kalır. Bu, kendi sunucunuzun her ziyaret için sayfaya yazdığı yerleştirmelere uygundur: sayfayı göstermeden önce REST API'den bir token ister ve onu iframe'in adresine koyar:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token, anahtarınız Authorization başlığında olmak üzere, 60 dakika geçerli bir token döndürür;
POST https://api.measuremaponline.com/api/v2/auth/token aynısını yapar ve saniye cinsinden, en fazla 24 saatlik bir duration kabul eder. Yanıtı, token'ın ne zaman sona ereceğini söyler.

Hesabınız saatte en fazla 600 token alabilir. Canlı anahtar kullanın: yerleştirmeler yalnızca canlı projeleri gösterir, bu yüzden sandbox anahtarıyla alınan token bir haritayı açmaz. Bkz. API başvurusu.

Ziyaretçiler neler yapabilir#

Ziyaretçiler haritayı kaydırabilir ve yakınlaştırabilir, şekillerinizin ölçümlerini ve projenin yorumlarını okuyabilir. Proje herkesin yorum yapmasına izin veriyorsa yorum ekleyebilir; projenin adına tıklamak kimliğini kopyalar. Başka hiçbir şeyi değiştiremezler: projenin erişim düzeyi ne olursa olsun yerleştirmede düzenleme kapalıdır. Tek istisna, ziyaretçilerin kendi başlarına ölçüm yaptığı, Open Guest planındaki bir Open Guest projesidir.

Harita görünmüyorsa#

Çoğu durumda harita nedenini söyleyen bir mesaj gösterir: bkz. harita bir mesaj gösterdiğinde. Sırayla şunları kontrol edin:

Adreste süresi dolmuş bir token var. Sunucunuz daha uzun süre istemediyse token'lar 60 dakika geçerlidir. Kodu, anahtarınızı kullanan Harita göm bölümünden yeniden kopyalayın ya da sunucunuzun her ziyaret için yeni bir token almasını sağlayın (bkz. yukarısı).
Proje özel. Sizinse Sadece görüntüleme ya da Herkese açık yapın veya Harita göm bölümünde Sadece görüntüleme yap düğmesine basın. Bir müşterinin projesiyse sizi haritadan yetkilendirebilir ya da onlardan Özel projeler bölümünden isteyebilirsiniz.
Projenin planı sona erdi: sahibinin planı ya da bir kuruluşun projesi için kuruluşun planı. Plan yenilendiğinde yeniden görünür.
Web sitesine izin verilmiyor. Anahtarın web sitesi kısıtlamaları varsa yerleştirmeyi gösteren sayfa bunlardan birinde olmalıdır. Bazı tarayıcılar ve siteler yerleştirmenin hangi sayfada olduğunu gizler; kısıtlamalar belirlenmişse böyle bir yerleştirme reddedilir.
Anahtar değiştirildi. Eski bir anahtar, yenisi oluşturulduktan 24 saat sonra ya da iptal edildiyse hemen durur.
Anahtar bir sandbox anahtarı. Yerleştirmeler yalnızca canlı anahtarlar ve canlı projelerle çalışır.
Abonelik etkin değil ya da API erişimi askıya alınmış: API anahtarları bölümü bunu söyler.