Tiles — تضمين خريطة أساس مصممة

يقوم product="tile" بتضمين خريطة أساس Kaleidr مصممة داخل iframe، حسب معرّف النمط. وهو يمتلك خريطته الخاصة؛ تحكم بها عبر واجهة postMessage المسماة kaleidr-embed:*.

طريقة الدمج: iframe — يتم تحميل الخريطة داخل map-embed.kaleidr.com.
النطاق المطلوب: maps.
الحد الأدنى للخطة: Free — يتم إنشاء مفتاح Free بنطاق ["maps"] وصلاحية منتج ["tile"]. Tile هو المنتج الوحيد الذي يحتاج إلى مفتاح ويمكن لـ Free تشغيله.

قبل البدء

يجب أن يكون أصل صفحتك ضمن قائمة الأصول المسموح بها للمفتاح. وإلا يفشل تبادل الجلسة بخطأ 403 session_origin_mismatch. لا يرسل file:// أي Origin ويفشل دائمًا — استخدم HTTP(S). راجع الحصول على مفتاح API.
يجب أن يسمح CSP الخاص بك بمحمّل SDK وإطار map-embed.kaleidr.com. لا تحتاج إلى مضيفي البلاطات / صور المزود لتضمين Tile فقط — فهي تعمل داخل iframe الخاص بـ Kaleidr. راجع Content Security Policy.

التركيب

<kaleidr-map product="tile" publishable-key="kld_pk_live_…" style-id="kaleidr-morning"
             center="-0.12,51.5" zoom="11" style="height:480px"></kaleidr-map>

تتضمن معرفات الأنماط المضمنة kaleidr-morning وkaleidr-afternoon و kaleidr-night وkaleidr-editorial وkaleidr-plain (وأسماء registry البديلة).

Handle

const handle = Kaleidr.mount('#basemap', {
  product: 'tile',
  publishableKey: 'kld_pk_live_…',
  styleId: 'kaleidr-night',
});

handle.setCamera({ center: [2.35, 48.85], zoom: 12 });
handle.setStyle('kaleidr-editorial');   // live style swap — tile only
handle.destroy();

setStyle(styleId) متاح فقط على tile handle. استدعاؤه على chat أو editor أو viewer يسجل تحذير [kaleidr] ثم يعيد.

مفتاح واحد، مجموعة واحدة

يقوم publishable-key (نطاق maps) بتفويض الوصول إلى خريطة الأساس — لا يوجد مفتاح منفصل للبلاطات — وكل جلسة خريطة أساس تُحتسب ضمن الحصة الشهرية المشتركة لتحميلات الخرائط في خطتك. راجع استخدام البلاطات.

قبل البدء​

التركيب​

Handle​

قبل البدء

التركيب

Handle