استخدام basemap مصممة

قم بتضمين basemap مصممة من Kaleidr كـ iframe، يتم اختيارها حسب style id و تفويضها بواسطة مفتاح publishable الخاص بك. يعمل Tile على جميع الخطط، بما فيها Free — ويتم إنشاء مفتاح Free-tier افتراضيًا بنطاق maps وصلاحية منتج tile.

يجب أن يكون origin الخاص بصفحتك ضمن allowlist الخاصة بالمفتاح وأن يتم تقديمها عبر HTTP(S) — راجع الحصول على مفتاح API.

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<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>

تشمل styles المتاحة kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain. راجع Tiles.

تمرير إعدادات الكاميرا

يتم احترام center, zoom, pitch, وbearing كلها في tile — سواء كـ attributes أو عبر handle.setCamera(...) بعد mount.

تبديل style مباشرة

يوفر tile handle الدالة setStyle(styleId):

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

// Later, swap to the night palette without remounting:
handle.setStyle('kaleidr-night');

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

القياس

الوصول إلى Basemap جزء من حساب Kaleidr الخاص بك: يقوم نطاق maps في مفتاحك بتفويضه، ويتم احتساب الاستخدام ضمن map-loads allowance في خطتك — وهو نفس المخزون الذي تستخدمه عمليات فتح الخرائط المشتركة وعروض الخرائط المضمنة. لا يوجد مفتاح tile منفصل ولا unauthenticated tile API.

الاستضافة الذاتية لـ basemap CDN

يمكن لعملاء Enterprise تقديم tiles من CDN مستقل. وجّه iframe الخاص بمنتج Tile إلى ذلك deployment باستخدام viewer-base (attribute) أو viewerBase (mount option). وهذا مستقل عن loader base (base / __KALEIDR_EMBED_BASE__) — راجع CDN versioning.