دليل نشر الخرائط

يحوّل نشر الخرائط خريطة قابلة للتحرير إلى تجربة مستقرة يستطيع الآخرون فتحها أو تضمينها أو استخدامها داخل منتج. الخيارات الرئيسية هي رابط مشاركة مستقل، أو عارض مضمّن، أو تكامل أعمق مع التطبيق. كما تحتاج خريطة الإنتاج إلى قواعد وصول، ونطاقات مسموح لها بالتضمين، وإصدار مباشر، وتخطيط للجوال، ومسارات للإطلاق وإلغاء النشر، وقياس — وليس مجرد عنوان URL.

تتناول الأقسام التالية نماذج النشر، وضوابط الوصول والنطاقات، وتخطيط التضمين، والمراسلة، والإصدارات، والتحليلات، وواجهات Kaleidr Studio وViewer. يتوفر سياق المنتج في Kaleidr Studio. ولآلية التضمين، راجع كيفية تضمين خريطة تفاعلية. ولمقارنة مسؤولية أداة الإنشاء وواجهة API، راجع أداة إنشاء الخرائط بلا برمجة مقابل واجهة API للخرائط. ولعمليات تركيب SDK، راجع ما هي حزمة SDK لخرائط الذكاء الاصطناعي؟.

أساسيات النشر

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

ماذا يعني نشر الخرائط؟

إنشاء الخريطة ونشرها مرحلتان مختلفتان. أثناء التأليف قد يغيّر الفريق الأماكن والطبقات والتسميات والألوان والبلاطات والكاميرا والمرشحات والتفاعلات ومصادر البيانات. ينشئ النشر واجهة للاستهلاك: صفحة مستقلة، أو تضمينًا في موقع، أو محدد مواقع ضمن SaaS، أو خريطة تحريرية، أو عرضًا داخليًا للقراءة فقط. تستطيع أداة التأليف تحمّل المسودات، لكن الخريطة المنشورة تحتاج إلى وصول وتخطيط وأداء وسلوك وإصدارات وإسناد ومراقبة يمكن توقعها. يصف Kaleidr Studio التأليف حاليًا بأنه Prompt → Process → Refine → Deploy، ويذكر إمكان نشر الخرائط المكتملة كصفحات مستقلة أو تضمينها كعناصر واجهة (Studio).

هل ينبغي للفرق مشاركة الخريطة المنشورة أم تضمينها أم دمجها؟

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

تصف وثائق Kaleidr الحالية للمطورين خرائط Viewer المنشورة بأنها محمية برابط مشاركة ويُشار إليها بمعرّف مشاركة بدلًا من مفتاح API عام (Viewer Embed). يعرّف معرّف المشاركة تجربة منشورة؛ فهو ليس سرًا للخادم ولا ينبغي معاملته كذلك. ويذكر Studio حاليًا إمكانية تضمين الخرائط كعناصر واجهة بعد النشر. يمكن ربط Chat بخريطة مضيفة موجودة، بينما صُمم Viewer حول تجربة خريطة منشورة (kaleidr.js).

كيف تتعامل تضمينات الإنتاج مع التخطيط والوصول والمراسلة؟

حدّد عقد النشر قبل الإطلاق: وصول عام أم مقيّد، والنطاقات المسموح لها بالتضمين، وحالات المسودة والمنشور والمؤرشف، وما إذا كانت الواجهة المباشرة تعرض لقطة بيانات خضعت للمراجعة. ينبغي أن تستخدم ضوابط النطاق أصولًا مجردة مثل https://www.example.com وhttps://app.example.com. تصف وثائق Viewer الحالية نطاقات مسموحًا بها يحددها الناشر للخرائط المنشورة المضمّنة. لا تجعل صفحة مضيفة محمية بتسجيل الدخول عنوان خريطة يمكن الوصول إليه مستقلاً خاصًا تلقائيًا؛ فالبيانات التجارية الخاصة تتطلب بنية تفويض مصممة لذلك.

احجز الارتفاع والعرض حتى لا ينهار التضمين. توصي مواصفة HTML بقيمة title موجزة لإطار iframe كي تتمكن التقنيات المساعدة من تسمية سياق التصفح المتداخل (HTML Standard)؛ أما المتطلب الصارم لاسم قابل للتحديد برمجيًا للإطارات فيقع في WCAG 4.1.2. استخدم التحميل الكسول للتضمينات خارج الشاشة بالسلوك المدعوم loading="lazy"؛ يعرّف معيار HTML سمات التحميل الكسول، ويوصي web.dev بتأجيل إطارات iframe غير المرئية لتقليل عمل الشبكة والبدء. أما الخريطة الرئيسية أعلى الجزء المرئي فينبغي تحميلها ضمن التجربة الأساسية. احتفظ ببديل نصي — أسماء أماكن أو عناوين أو قائمة — حتى تعمل الصفحة إذا تعطل العارض.

تنتمي الاتصالات بين الأصول إلى قناة مضبوطة. تمثل window.postMessage() الآلية القياسية بين النوافذ وإطارات iframe (HTML Standard). تحقّق من event.origin للرسائل الواردة وحدد أصلًا مستهدفًا بعينه للرسائل الصادرة؛ لا تستخدم "*" افتراضيًا. تصف وثائق Viewer واجهة رسائل kaleidr-embed:* للسلوك المدعوم. يجب أن تبقى حالة العارض منفصلة عن حالة المضيف: تتحكم الخريطة المنشورة في الكاميرا والتحديد داخل العارض، بينما تتحكم الصفحة المضيفة في التنقل والنماذج والتحويل.

// Published Viewer mount: share ID, not a server key
Kaleidr.mount("#published-map", {
  product: "viewer",
  shareId: "YOUR_SHARE_ID"
});

كيف تدير الفرق إصدارات الخرائط المنشورة وقياسها والتراجع عنها؟

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

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

ما أخطاء نشر الخرائط التي ينبغي للفرق تجنبها؟

الخلاصة النهائية

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

انشر الخرائط باستخدام Kaleidr Studio

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

الأسئلة الشائعة

ما نشر الخرائط؟

هو تحويل خريطة قابلة للتحرير إلى تجربة مستقرة يستطيع الآخرون فتحها أو تضمينها أو استخدامها في منتج، مع ضوابط الوصول والتخطيط والإصدارات والقياس.

ما الفرق بين رابط المشاركة والتضمين؟

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

متى يستخدم الفريق تكامل المنتج بدلًا من التضمين؟

عندما يجب أن تبقى المرشحات أو السجلات المحددة أو حالة سير العمل متزامنة مع الخريطة بدلًا من مجرد إحاطة عارض مستقل.

هل يحتاج Kaleidr Viewer إلى مفتاح API؟

تصف الوثائق الحالية خرائط Viewer المنشورة بأنها محمية برابط مشاركة لا بمفتاح API. راجع أحدث الوثائق قبل النشر لأن نماذج الوصول قد تتطور.

هل معرّف المشاركة هو نفسه مفتاح API؟

لا. يعرّف معرّف المشاركة تجربة منشورة. أما مفتاح API للخادم فيصرّح بعمليات مميّزة ويجب أن يظل سريًا.

هل ينبغي تحميل تضمين الخريطة تحميلًا كسولًا؟

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

كيف أجعل خريطة iframe قابلة للوصول؟

امنح iframe قيمة title موجزة، ووفر HTML محيطًا مفيدًا، وادعم مهام لوحة المفاتيح، وقدّم معلومات نصية لا تتطلب سحب الخريطة.

هل يمكن لصفحتين من أصلين مختلفين الاتصال بخريطة مضمّنة؟

نعم إذا كان التكامل يدعم ذلك. توفر window.postMessage() مراسلة مضبوطة. استخدم أصلًا مستهدفًا محددًا وتحقق من أصول الرسائل الواردة.

هل يمكن نشر بيانات أعمال خاصة عبر تضمين خريطة؟

فقط إذا صُممت بنية النشر والتفويض لذلك. حماية الصفحة المضيفة بتسجيل الدخول لا تجعل عنوان الخريطة المستقل خاصًا تلقائيًا.

هل ينبغي أن يكون للخريطة المنشورة إصدارات؟

نعم عندما قد تؤثر التغييرات في العملاء أو التضمينات أو التقارير أو مسارات العمل. تجعل الإصدارات التراجع وتصحيح الأخطاء أكثر أمانًا.

هل يستطيع Kaleidr Studio نشر الخرائط بلا برمجة؟

نعم. تذكر صفحة Studio الحالية أن المؤلفين يمكنهم إنشاء الخرائط وتحسينها بصريًا ثم نشرها كصفحات مستقلة أو عناصر واجهة قابلة للتضمين.

المراجع

• Kaleidr. Design Custom Maps, Powered by Spatial AI. Kaleidr Studio. تم الاطلاع في 19 أغسطس 2026. https://kaleidr.com/studio
• Kaleidr. kaleidr.js Loader. Kaleidr Developer Documentation. تم الاطلاع في 19 أغسطس 2026. https://docs.kaleidr.com/sdk/kaleidr-js
• Kaleidr. Viewer Embed. Kaleidr Developer Documentation. تم الاطلاع في 19 أغسطس 2026. https://docs.kaleidr.com/sdk/viewer-embed
• WHATWG. HTML Standard — Lazy loading attributes. تم الاطلاع في 19 أغسطس 2026. https://html.spec.whatwg.org/multipage/urls-and-fetching.html#lazy-loading-attributes
• WHATWG. HTML Standard — The iframe element. تم الاطلاع في 19 أغسطس 2026. https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-iframe-element
• W3C. Understanding Success Criterion 4.1.2: Name, Role, Value. WCAG 2.2. تم الاطلاع في 19 أغسطس 2026. https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html
• WHATWG. HTML Standard — Posting messages. تم الاطلاع في 19 أغسطس 2026. https://html.spec.whatwg.org/multipage/web-messaging.html#posting-messages
• web.dev. Lazy load images and iframe elements. تم الاطلاع في 19 أغسطس 2026. https://web.dev/learn/performance/lazy-load-images-and-iframe-elements

@misc{kaleidr_studio_publish_2026,
  title  = {Design Custom Maps, Powered by Spatial AI},
  author = {{Kaleidr}},
  note   = {Kaleidr Studio; accessed 19 August 2026},
  url    = {https://kaleidr.com/studio}
}

@misc{kaleidr_viewer_embed_2026,
  title  = {Viewer Embed},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Documentation; accessed 19 August 2026},
  url    = {https://docs.kaleidr.com/sdk/viewer-embed}
}

@misc{kaleidr_js_loader_2026,
  title  = {kaleidr.js Loader},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Documentation; accessed 19 August 2026},
  url    = {https://docs.kaleidr.com/sdk/kaleidr-js}
}

@misc{whatwg_iframe_2026,
  title  = {HTML Standard -- The iframe element},
  author = {{WHATWG}},
  note   = {Accessed 19 August 2026},
  url    = {https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-iframe-element}
}

@misc{wcag_412_2026,
  title  = {Understanding Success Criterion 4.1.2: Name, Role, Value},
  author = {{W3C}},
  note   = {WCAG 2.2; accessed 19 August 2026},
  url    = {https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html}
}

@misc{whatwg_lazy_loading_2026,
  title  = {HTML Standard -- Lazy loading attributes},
  author = {{WHATWG}},
  note   = {Accessed 19 August 2026},
  url    = {https://html.spec.whatwg.org/multipage/urls-and-fetching.html#lazy-loading-attributes}
}

@misc{whatwg_postmessage_2026,
  title  = {HTML Standard -- Posting messages},
  author = {{WHATWG}},
  note   = {Accessed 19 August 2026},
  url    = {https://html.spec.whatwg.org/multipage/web-messaging.html#posting-messages}
}

@misc{webdev_lazy_iframe_2026,
  title  = {Lazy load images and iframe elements},
  author = {{web.dev}},
  note   = {Accessed 19 August 2026},
  url    = {https://web.dev/learn/performance/lazy-load-images-and-iframe-elements}
}