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

Viewer

يضع Viewer خريطة نشرتها في Kaleidr Studio على صفحتك. تُعرض الخريطة داخل iframe تستضيفه Kaleidr، فلا تحتاج صفحتك إلى تحميل مكتبة خرائط أو استخدام مفتاح API. ويكفي معرّف الخريطة المنشورة لتضمينها.

استخدم Viewer عندما تكون الخريطة موجودة في Studio وتريد عرضها للزوار، مثل محدد مواقع المتاجر، أو خريطة حرم جامعي، أو مسار فعالية، أو خريطة بيانات ضمن مقال.

نظرة سريعة​

السؤالالإجابة
ماذا أحتاج؟معرّف خريطة منشورة، دون مفتاح API أو جلسة.
أي خطة؟كل الخطط، بما فيها Free. يتطلب النشر حساب Kaleidr.
كيف تُعرض؟داخل iframe من https://map-embed.kaleidr.com.
ماذا تعرض؟الخريطة كما نشرها مؤلفها: علامات ومسارات وطبقات منسقة ومجموعات بيانات وتراكبات صور رُفعت في لوحة البيانات داخل Studio.
كيف أضمّنها؟باستخدام <iframe> عادي أو عنصر SDK المسمى <kaleidr-map product="viewer">.
ما التكلفة؟تُحتسب كل مشاهدة تحميل خريطة واحدًا على مؤسسة مالك الخريطة.
هل تستطيع الصفحة التحكم بالخريطة؟يمكنها تحديد الكاميرا وتحريكها والاستماع إلى رسائل التحميل والخطأ فقط.

أبسط تضمين​

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer"
             share-id="YOUR_MAP_ID"
             style="display:block; height:480px"></kaleidr-map>

استبدل YOUR_MAP_ID بالمعرّف الذي يعرضه Studio في رمز التضمين بعد النشر. يستخدم العنصر display:block افتراضيًا، لذا يعمل height. ويُدرج المثال display:block أيضًا لتوافق Safari قبل 16.4، حيث يبقى العنصر ضمن السطر ويتجاهل height.

إذا لم تتمكن من إضافة برنامج نصي إلى الصفحة (مثل أداة إنشاء مواقع أو CMS أو أداة رسائل إخبارية تقبل HTML)، فاستخدم iframe الذي ينشئه Studio بدلًا من ذلك:

<iframe
  src="https://map-embed.kaleidr.com/embed/YOUR_MAP_ID"
  width="100%"
  height="480"
  style="border:0;"
  loading="lazy"
  referrerpolicy="no-referrer-when-downgrade"
  allow="geolocation; microphone; fullscreen; clipboard-write"
  title="Kaleidr map"
></iframe>

تعرض الطريقتان الخريطة نفسها. يوضح تضمين خريطة منشورة متى تختار كل طريقة.

كيفية العمل​

  1. تنشر خريطة في Studio، فيمنحها معرّفًا ورمز تضمين.
  2. تحمّل صفحتك الرمز. يشير عنصر SDK أو iframe العادي إلى https://map-embed.kaleidr.com/embed/YOUR_MAP_ID.
  3. تجلب الصفحة داخل iframe الخريطة المنشورة وترسمها مع مجموعات البيانات وتراكبات الصور التي رفعها المؤلف. وإذا كانت للخريطة قائمة نطاقات مسموحة، تتحقق أولًا من وجود نطاق صفحتك فيها.
  4. عند اكتمال الرسم، يرسل iframe رسالة kaleidr-embed:ready إلى صفحتك. وإذا تعذر الرسم، يرسل kaleidr-embed:error ويعرض للزائر شرحًا قصيرًا بدل الخريطة.

لا تتلقى صفحتك بيانات الخريطة ولا تستطيع الوصول إلى داخل iframe. وتبقى مكتبة الخرائط والأنماط وطلبات الشبكة داخل الإطار، لذلك لا تحتاج سياسة أمان المحتوى إلا إلى السماح بالإطار.

ما يستطيع الزائر فعله​

  • تحريك الخريطة وتدويرها وإمالتها، والتكبير بأزرار الخريطة أو حركة القرص بالأصابع أو عجلة التمرير. يكبّر التمرير الخريطة حين يكون المؤشر فوقها، كما في Studio. وحين يكون المؤشر خارج الخريطة يحرّك التمرير صفحتك.
  • عرض موقعهم باستخدام زر الموقع، بعد أن يطلب المتصفح إذنهم.
  • فتح نوافذ الأماكن المنبثقة بالنقر على الخريطة إذا فعّلها المؤلف في Studio.
  • قراءة وسائل الإيضاح وسطر نسب المصادر أسفل الخريطة.
  • سؤال Kaleidr AI عن الخريطة، في لوحة Ask Kaleidr إذا فعّل المؤلف Control Tower في لوحة Kaleidr AI في Studio، وفي النوافذ المنبثقة إذا كان Popup Window مفعّلًا. راجع Kaleidr AI على خريطة منشورة.

التضمين للقراءة فقط. لا يستطيع الزوار تعديل الخريطة، ولا يُحفظ أي إجراء يتخذونه.

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

  • تحديد الكاميرا الابتدائية باستخدام center وzoom وpitch وbearing. الافتراضي هو العرض الذي حفظه المؤلف، وتتقدم القيم التي تمررها صفحتك عليه لكل حقل على حدة.
  • تحريك الكاميرا لاحقًا باستخدام handle.setCamera(...) أو تغيير سمات الكاميرا في العنصر.
  • معرفة نجاح التحميل أو فشله بالاستماع إلى الرسالتين اللتين يرسلهما iframe.
  • إزالة الخريطة باستخدام handle.destroy() أو حذف العنصر.

عناصر التحكم لمالك الخريطة​

تتوفر هذه الإعدادات في Studio، لا في رمز التضمين:

  • النشر وإلغاء النشر. تعرض الخريطة المنشورة ما هو محفوظ حاليًا في Studio، لذا تصبح التعديلات المحفوظة علنية عند التحميل التالي للتضمين دون الحاجة إلى إعادة النشر. إعادة النشر تسجل نسخة منشورة جديدة مع الحفاظ على الرابط نفسه. لتعديل الخريطة بشكل خاص، ألغِ نشرها أولًا ثم أعد نشرها بعد الانتهاء. إلغاء النشر يوقف جميع تضمينات الخريطة، وإعادة النشر تستعيد عناوين URL نفسها. راجع إلغاء نشر خريطة.
  • البيانات المرفوعة. تظهر مجموعات البيانات وتراكبات الصور المرسومة في الخريطة المنشورة لزوارها. احذف مجموعة بيانات من لوحة البيانات أو ألغِ نشر الخريطة لإيقاف تقديمها. تظل روابط المشاركة عاملة بعد إلغاء النشر، لكن حذف مجموعة البيانات يزيلها من روابط المشاركة أيضًا. الخريطة المنشورة عامة، فلا تنشر إلا البيانات التي يمكن لأي شخص قراءتها. راجع البيانات المرفوعة على خريطة منشورة.
  • النطاقات المسموحة. قيّد المواقع التي يمكن عرض الخريطة عليها. يستخدم الفحص عنوان الإحالة الذي ترسله صفحتك؛ لذلك لا يمكن عرض خريطة مقيدة بالنطاقات في صفحة لا ترسل عنوان إحالة.
  • Kaleidr AI. فعّل لوحة Ask Kaleidr (Control Tower) ومحادثة AI في النوافذ المنبثقة (Popup Window) من لوحة Kaleidr AI الخاصة بالخريطة.

القيود​

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

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