إنتقل إلى المحتوى الرئيسي

المحرر

يدمج Editor أدوات تحرير خرائط Kaleidr داخل صفحتك: خريطة أساس من Kaleidr مع أدوات لإضافة النصوص والصور والعلامات والنوافذ المنبثقة وإعادة تصميم العناصر الظاهرة على الخريطة.

تعرّف على نطاق العمل قبل التطوير

المحرر المضمّن أداة تعمل داخل الصفحة وتبقى نتائج عملها في ذاكرة الصفحة. لا يُحفظ أو يُصدَّر أو يُنشر شيء من التضمين، ولا تتلقى صفحتك استدعاءً راجعًا عند حدوث تغيير. تضيع التعديلات عند إعادة تحميل الصفحة أو تدمير المحرر. ولا يوفر ذلك سير عمل لنشر الخرائط للمستخدمين. لإنشاء خرائط تُحفظ وتُشارك وتُضمَّن، أنشئها في Kaleidr Studio واعرضها باستخدام Viewer.

نظرة سريعة​

السؤالالإجابة
ما الذي أحتاج إليه؟مفتاح قابل للنشر (kld_pk_live_…) يتضمن النطاق design، وهو موجود افتراضيًا في المفاتيح الجديدة.
أي خطة؟جميع الخطط، بما فيها Free.
كيف يُعرض؟داخل صفحتك لا في iframe. تصبح الخريطة ولوحات المحرر عناصر في مستندك.
أين تذهب التعديلات؟لا تُحفظ في أي مكان. تبقى في ذاكرة الصفحة حتى إعادة تحميلها أو تدمير المحرر.
هل يمكن لكودي قراءة التعديلات؟لا. لا يوجد حدث تغيير ولا تصدير ولا وصول إلى كائن الخريطة.
كم محررًا في الصفحة؟واحد.

أبسط تثبيت​

<div id="editor" style="height:640px"></div>

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<script>
  const handle = Kaleidr.mount('#editor', {
    product: 'editor',
    publishableKey: 'kld_pk_live_…',
  });
</script>

يجب تحديد ارتفاع لعنصر التثبيت المستهدف. يملأ المحرر هذا العنصر بالكامل.

ما يتضمنه المحرر المضمّن​

يتضمن شريط أدوات المحرر ثمانية عناصر:

  • النص: العناوين والنصوص الموضوعة على الخريطة.
  • الصورة: صور توضع على الخريطة.
  • العلامة: علامات على مواقع محددة.
  • النافذة المنبثقة: نوافذ مرتبطة بمواقع.
  • الخلفية: الخلفية الموجودة خلف الخريطة.
  • الطبقة: طبقات خريطة الأساس نفسها: التسميات والمباني ثلاثية الأبعاد والإضاءة والتضاريس.
  • التصميم: تحديد معلم في خريطة الأساس أو فئة من المعالم أو منطقة وإعادة تصميم نمطها.
  • وسيلة الإيضاح: إعدادات التسميات ووسائل الإيضاح.

ما لا يتضمنه​

أجزاء Kaleidr Studio التالية غير متاحة في المكوّن المضمّن:

  • علامة تبويب البيانات: لا يمكن رفع مجموعات البيانات، لذلك لا تجد أدوات تنسيق البيانات المرفوعة بيانات للعمل عليها.
  • كتالوج تصاميم Studio الذي يتضمن خرائط نموذجية وأنواع الأنماط.
  • لوحة الذكاء الاصطناعي.
  • مكتبة النماذج ثلاثية الأبعاد.
  • المشاركة والنشر.
  • المشاريع: لا توجد قائمة خرائط محفوظة ولا إمكانات الفتح أو الحفظ.
  • تسجيل الدخول: يعمل التضمين باستخدام مفتاحك لا باستخدام حساب Kaleidr لشخص ما.

آلية العمل​

  1. يستبدل SDK مفتاحك القابل للنشر بجلسة قصيرة الأجل. وتتحقق هذه الخطوة من المفتاح ونطاقه design وأصل صفحتك.
  2. في الوقت نفسه، يحمّل SDK حزمة المحرر editor.js من https://cdn.kaleidr.com. حجمها عدة ميغابايت ولا تُحمّل إلا عند تثبيت محرر. يبدأ المحرر بعد اكتمال الخطوتين.
  3. ينشئ المحرر خريطة داخل العنصر المستهدف ويحمّل خريطة الأساس من https://tile.kaleidr.com. تحمل طلبات النمط والرسومات والخطوط مفتاحك القابل للنشر حتى يتعرف مضيف خريطة الأساس على صفحتك. لا يوضع رمز الجلسة في عنوان URL مطلقًا.
  4. تظهر لوحات المحرر فوق الخريطة داخل عنصر التثبيت المستهدف.

بما أن جميع هذه المكونات تعمل في صفحتك، يجب أن تسمح سياسة أمان المحتوى لديك بموارد أكثر مما تحتاجه منتجات Viewer أو Tile. ترد التعليمات الدقيقة في سياسة أمان المحتوى.

ما يمكن لصفحتك فعله​

  • اختيار خريطة الأساس باستخدام styleId، مثل kaleidr-night.
  • ضبط الكاميرا الابتدائية باستخدام center وzoom وpitch وbearing.
  • تحريك الكاميرا لاحقًا باستخدام handle.setCamera(...).
  • مواءمة هوية علامتك التجارية باستخدام theme، وهو كائن من 17 مفتاحًا مسمى مثل brandColor وfontPrimary.
  • إزالة المحرر باستخدام handle.destroy().

الحدود​

  • لا يُحفظ أو يُصدَّر أو يُنشر شيء ولا توجد استدعاءات راجعة للتغييرات.
  • لا يكشف المقبض كائن الخريطة. لا يمكنك إضافة طبقاتك الخاصة أو قراءة ما رسمه المستخدم.
  • تُثبَّت خريطة الأساس والمظهر عند التثبيت. لتغيير أي منهما عليك تدمير المحرر وتثبيته مجددًا، ما يمحو التعديلات.
  • يمكن تشغيل محرر واحد فقط في الصفحة في المرة الواحدة.
  • تُطبَّق قيم المظهر على المستند كله أثناء تثبيت المحرر وتُستعاد القيم السابقة عند تدميره.
  • لا تصل إلى كودك إشارات جاهزية أو فشل. تظهر الأخطاء في وحدة تحكم المتصفح.

الخطوات التالية​