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

سجل التغييرات

التغييرات المهمة في SDK للتضمين وواجهة API للمنصة وهذه المستندات. يُرقَّم إصدار SDK عند /embed/v1/* وإصدار API عند /inference-api/b2b/v1/*؛ ويُصدر أي تغيير غير متوافق كإصدار رئيسي جديد إلى جانب القديم (إصدارات CDN). أما الإضافات، مثل حدث بث جديد أو حقل استجابة إضافي، فتُطرح دون تغيير الإصدار، ولذلك يجب أن تتجاهل التطبيقات العميلة العناصر التي لا تتعرف عليها.

2026-10-21: شريط الدردشة في Viewer، وتفعيل الإجابات من أماكن الخريطة نفسها​

  • شريط دردشة لصفحتك. يمثّل <kaleidr-map product="viewer" layout="bar"> حقل سؤال واحدًا يفتح الخريطة المنشورة بسؤال الزائر: فوق الصفحة افتراضيًا، أو على صفحتك أنت باستخدام results-url. والعنوان والنص الإرشادي وأمثلة الأسئلة ولون التمييز والمظهر واللغة كلها سمات. راجع شريط الدردشة.
  • يمكن أن يُفتح Viewer بسؤال. تطرح prompt، أو prompt-param لقراءته من عنوان URL للصفحة، ومعامل q في iframe سؤالًا على Kaleidr AI الخاص بالخريطة عند فتحها؛ ويطرح handle.send() السؤال من الشيفرة. تغيير إضافي: لا تغيير في الإصدار.
  • تفعيل الإجابات من أماكن الخريطة نفسها. تجيب لوحة Ask Kaleidr على الخريطة المنشورة أو رابط المشاركة أولًا من الأماكن المسماة التي تعرضها الخريطة. راجع الإجابات من أماكن الخريطة نفسها.
  • متجر القوالب يكتب الشيفرة. ينشئ template.kaleidr.com المقتطفين كليهما لخريطة تختارها. وأُوقفت قوالب المواقع القابلة للتنزيل.

2026-10-18: يحتاج Kaleidr AI في رابط المشاركة إلى أن تكون خريطته منشورة​

  • يتوقف Kaleidr AI في رابط المشاركة عند إلغاء نشر خريطته. ولا يعمل كذلك إلا على الصفحات التي تشملها النطاقات المسموحة للخريطة الآن، لا نطاقات لقطة الرابط. ويوقفه إلغاء نشر الخريطة أو إزالة نطاق الصفحة خلال خمس دقائق، كما على الخريطة المنشورة، ويعيده النشر مجددًا. ولا يزال مفتاحا Control Tower وPopup Window يأتيان من اللقطة، ويظل الرابط نفسه يعرض خريطته. ويُرجع POST /sdk/share-sessions الرمز 404 not_found لرابط مشاركة أُلغي نشر خريطته. راجع Kaleidr AI على خريطة منشورة.

2026-10-16: يتبع Kaleidr AI على الخريطة المنشورة مفاتيح الخريطة نفسها​

  • لوحة Kaleidr AI الخاصة بالخريطة هي المفتاح الوحيد. في Studio، يمنح Control Tower زوار الخريطة المنشورة لوحة Ask Kaleidr، ويمنحهم Popup Window محادثة AI في نوافذها المنبثقة، في iframe وعنصر Viewer على حد سواء. أُزيل مفتاح Visitor AI Chat من Share ثم Embed. راجع Kaleidr AI على خريطة منشورة.
  • لا يوجد حد شهري لكل خريطة. أُزيل حقل Monthly AI Credit Limit. يستهلك الزوار أرصدة AI للمالك حتى الحصة التي تتيحها الخطة؛ ولم تتغير حدود المعدل لكل زائر ولكل خريطة.
  • تقبل POST /sdk/share-sessions الحقل feature. القيمة control_tower (الافتراضية) أو popups، ولا تُمنح كل منهما إلا ما دام مفتاحها مفعّلًا، وإلا فالاستجابة 403 chat_disabled. راجع POST /sdk/share-sessions.
  • يفتح رابط المشاركة Kaleidr AI أيضًا. يُمنح معرّفه وفق لقطة الرابط: مفتاحا Control Tower وPopup Window والنطاقات المسموحة كما كانت عند إنشاء الرابط، ويدفع مالك الخريطة التكلفة. ولا يؤدي إيقاف Kaleidr AI في Studio إلى إيقافه على رابط مشاركة سبق توزيعه. ويبقى المعرّف غير المعروف 404 not_found.
  • يكبّر Viewer وTile بالتمرير، كما في Studio. يكبّر التمرير الخريطة حين يكون المؤشر فوقها، دون Ctrl أو ⌘؛ وحين يكون المؤشر خارج الخريطة يحرّك التمرير الصفحة. ولم تعد المعلمة gestures=greedy في iframe تُقرأ.

2026-10-14: ما الموجود عند نقطة معينة، وإهمال نقطتي نهاية​

  • جديد: POST /spot وPOST /spot/overview/stream. يحدد /spot ما يوجد عند نقطة معينة: المكان الذي نقر عليه المستخدم وأقرب عنوان بريدي والمناطق التي تحتوي النقطة، مع بيانات الإسناد الواجب عرضها لكل قيمة. ويمكن إضافة وصف المكان وصوره عند الطلب. يبث /spot/overview/stream نظرة عامة على أحد العناصر المعادة، بعد إطار place يحمل الاسم الكامل للمكان. راجع POST /spot.
  • لا يفرض /spot رسم المحتوى إلا عندما يُجلب للاستدعاء. المحتوى الذي جُلب لطلب سابق لا يكلف شيئًا، لذا فإن بحث المحتوى عبر /spot يكلف مثل /retrieval/poi/enrich أو أقل.
  • مهملان: GET /retrieval/poi/enrich وPOST /chat/summary/stream. سيواصلان الاستجابة كما في السابق حتى 2027-01-15 ويمكن إزالتهما بعد ذلك في أي وقت. تتضمن الاستجابات Deprecation وSunset وLink إلى البديل. راجع الانتقال من نقاط النهاية المهملة.
  • إرجاع tenants. يعيد /spot الأنشطة التجارية داخل مبنى على شكل كيانات tenant لها مرجع poi: بموجب ترخيص CDLA-Permissive-2.0 بدلًا من حجبها. وتظل هذه العملية مجانية.
  • تُحتسب تكلفة كل ملخص. تُحاسب ملخصات الأماكن ونظراتها العامة بناءً على الرموز المستخدمة في كل طلب، ولم يعد حقل cached يُرسل في حدثي start وend.
  • لا يوجد بديل لملخصات المباني. لا تتوفر نظرة عامة على المبنى عبر واجهة API. راجع ما لا تعيده الواجهة. يقبل /spot/overview/stream القيمة building: دون معرّف، ويرد عليها، كما يفعل مع building:<id>، بإطار error واحد.

2026-10-13: تغييرات المنتج وتصحيح التوثيق وتوسيعه​

ينقسم هذا التحديث إلى جزأين. يوضح تغييرات المنتج وحدود API وحالات الرفض ما تغير في المنتج مع هذا الإصدار. ويبين تصحيحات هذه الصفحات المواضع التي وصفت فيها المستندات وظائف لا يقدمها المنتج؛ فقد تمت مراجعة الصفحات سطراً بسطر بمقارنتها مع SDK وAPI، ثم تصحيحها وتوسيعها. إذا كنت قد بنيت تكاملاً اعتماداً على إصدار سابق من هذه الصفحات، فاقرأ التصحيحات.

تغييرات المنتج​

  • تُرفع بيانات الأنشطة التجارية في Kaleidr Studio. توجد شاشة الرفع في قسم Data for AI Answers أسفل لوحة البيانات في أي خريطة. اختر ملف .csv أو .json، واقترح تعيين أعمدة CSV وراجعه، ثم عاين البيانات وانشرها واعرض النتيجة في قائمة Releases. هذه شاشة الرفع الوحيدة، ولا تظهر عناصرها إلا لمالكي المؤسسات أو مسؤوليها المخوّلين بالرفع. وتستخدم نفس مسار المعالجة الذي تستعمله واجهة الرفع البرمجية دون تغيير. المؤسسة التي غادرت Enterprise لكنها ما زالت تحتفظ بإصدارات منشورة تحتفظ بهذا القسم لمالكيها ومسؤوليها مع عبارة «الرفع جزء من خطة Enterprise» وقائمة Releases، بينما لا يظهر القسم لبقية المؤسسات دون Enterprise. راجع الإجابات من بياناتك الخاصة وما يظهر عند تعذّر الرفع.
  • بيانات الأنشطة التجارية حصرية لخطة Enterprise، للرفع والإجابات معًا. يستطيع مالك مؤسسة Enterprise أو مسؤولها رفع البيانات ونشرها. ولا يجيب مساعد Kaleidr Studio باستخدام هذه البيانات إلا لأعضاء المؤسسة المسجّلين دخولهم ما دامت على خطة Enterprise. لا تسمح Free وPro برفعها. تُحدد حدود الأماكن والمستندات وأحجام الملفات لكل مؤسسة في اتفاقيتها، دون تجاوز الحدود القصوى للمنصة. تعيد عملية الرفع المتجاوزة للحد استجابة 422 تذكر الحد والخطة في السبب. وتعتمد خطة Kaleidr الخاصة بالمؤسسة التي تم شراؤها أو تعديلها في kaleidr.com/billing. كما تتطلب قراءة البيانات عبر مفاتيح API أو SDK النطاق vendor المتاح حصريًا لخطة Enterprise. راجع التوفر حسب الخطة.
  • تختلف حدود مجموعات بيانات الخريطة حسب الخطة. يستطيع المستخدم المسجل دخوله إضافة ملفات إلى خريطة من لوحة البيانات في Kaleidr Studio ضمن جميع الخطط، مع الحدود التالية: في Free، ‏50,000 صف لكل مجموعة بيانات، و32 MiB لكل ملف، و250,000 صف لجميع مجموعات المؤسسة؛ وفي Pro، ‏100,000 صف و64 MiB و5,000,000 صف على الترتيب. أما Enterprise فتطبّق الحدود الفردية لمجموعة البيانات والملف نفسها في Pro، ويُحدد الحد الإجمالي للمؤسسة في الاتفاقية. تجاوز حد الخطة يرفض عمليات الرفع الجديدة فقط مع HTTP 402 quota_exceeded، وتبقى البيانات المخزنة سابقًا. وتنطبق أربعة حدود قصوى على جميع الخطط بما فيها Enterprise ويؤدي تجاوزها إلى HTTP 400 VALIDATION_ERROR لا 402: ملف أكبر من 64 MiB، أو مجموعة تتجاوز 100,000 صف، أو ملف جغرافي يتجاوز 50,000 معلم، أو طبقة صورة تتجاوز 16 MiB (الصورة التي يولدها Studio من GeoTIFF، لا ملف GeoTIFF الأصلي). يُخزّن JSON الملصق في أداة الرفع داخل الخريطة نفسها لجميع المستخدمين ولا يُحتسب ضمن هذه الحدود. راجع مجموعات البيانات على الخريطة والأخطاء.
  • لا تضيف عملية رفع مجموعة بيانات مرفوضة شيئًا إلى الخريطة. يعرض Studio أي رفض من الخادم بجانب أداة الرفع ولا يضيف الملف: حد الخطة (402) مع رسالة الخادم ورابط Upgrade Plan، أو جلسة غير مسجلة، أو نقص الصلاحية، أو ملف كبير، أو عدد رفع زائد، أو أي رفض آخر بما فيه 400 عند تجاوز حد عام. فقط إذا لم يجب الخادم أو انتهت المهلة أو حدث عطل، يمكن تخزين الصفوف داخل الخريطة مع تحذير، بشرط أن يلتزم الجدول بحدود الخطة؛ وإلا فلن يُضاف شيء. راجع عندما لا ينجح الرفع.
  • حذف مجموعة بيانات من لوحة البيانات حذف نهائي. تطلب أيقونة سلة المحذوفات تأكيدًا، ثم تحذف المجموعة وتزيلها وطبقاتها من الخريطة وتحرر صفوفها من إجمالي المؤسسة. تتوقف إتاحتها على الخريطة المنشورة وروابط المشاركة. رفع ملف بالاسم نفسه يستبدل المجموعة السابقة بعد تخزين الملف الجديد؛ وإذا تعذرت قراءة الجديد تعود الخريطة إلى البيانات السابقة ويعرض Studio تنبيهًا. قد تعيد وظيفة التراجع مرجع الخريطة إلى مجموعة محذوفة، لكن لن تُرسم الطبقة. راجع حذف مجموعة بيانات أو استبدالها.
  • تتبع حدود Studio خطة Kaleidr الخاصة بالمؤسسة. يعتمد عدد الخرائط التي يمكن للمؤسسة الاحتفاظ بها وحدود مجموعات البيانات السابقة على الخطة التي اشتُريت وعُدلت في kaleidr.com/billing. ليس لـ Kaleidr Studio خطة منفصلة.
  • تعرض الخريطة المنشورة ورابط المشاركة بيانات الخريطة المرفوعة. تُرسم مجموعات البيانات التي أضيفت في لوحة Studio كطبقات، وتُعرض تراكبات الصور، في العارض المضمن وروابط المشاركة. لا تُقدّم إلا البيانات المدرجة في الخريطة المنشورة. حذف مجموعة من لوحة البيانات يوقف عرضها في الخريطة المنشورة وكل روابط المشاركة التي استخدمتها. إلغاء نشر الخريطة يوقف تضميناتها، لكن الروابط التي سبق مشاركتها تواصل العمل بالبيانات التي كانت لديها. يحتفظ المتصفح بالبيانات المحمّلة مسبقًا وقد يبقى رابط تنزيل صادر متاحًا لمدة تصل إلى ساعة. ينزّل كل زائر مجموعة البيانات كاملة بجميع أعمدتها؛ لذا تتباطأ الجداول الكبيرة عند التحميل وتكون مجموعة البيانات المنشورة عامة. راجع البيانات المرفوعة على خريطة منشورة.
  • يمكن إلغاء نشر خريطة من Studio. تحتوي صفحة Publish & embed للخريطة الحية على زر Unpublish مع طلب تأكيد. بعدها تعرض كل التضمينات رسالة تفيد بأن الخريطة غير متاحة. تحتفظ الخريطة بمعرّفها، ولذلك تعيد إعادة نشرها عناوين URL المضمنة نفسها. راجع إلغاء نشر خريطة.
  • يجيب مساعد Studio الذكي عن مجموعة البيانات بأكملها. في الخريطة المفتوحة يعمل على جميع صفوف المجموعة المرفوعة، لا على عينة فقط، فيستطيع التصفية والفرز والعد والجمع والمتوسط والتجميع والبحث عن الصفوف قرب نقطة أو داخل منطقة. يتعامل مع مجموعة واحدة في كل مرة ويعرض حتى 100 صف أو مجموعة ويقرأ البيانات دون تعديلها. راجع سؤال المساعد عن مجموعة بيانات.
  • لمجموعات البيانات أدوار للأعمدة. بعد الرفع يكتشف Studio أعمدة الاسم والفئة والوصف والعنوان، ويمكن للمؤلف تصحيحها في قسم Column Roles للمجموعة داخل لوحة البيانات. عمود الاسم هو ما يستخدمه مساعد Studio الذكي والدردشة في الخريطة المنشورة لتسمية الأماكن. يؤدي رفع ملف بالاسم نفسه إلى تخزين مجموعة جديدة، وتُنقل أدوار الأعمدة من السابقة إذا بقيت تلك الأعمدة في الملف الجديد. راجع أدوار الأعمدة.
  • يمكن لـ Visitor AI Chat الإجابة من مجموعات البيانات المرفوعة إلى خريطة منشورة عند تفعيل الإجابات من الأماكن الموجودة على الخريطة. تتحكم Kaleidr في إتاحة هذه الوظيفة على مستوى المنصة وتكون معطلة افتراضيًا. عند تفعيلها تشمل الأماكن التي تقرؤها الدردشة صفوف مجموعات البيانات المدرجة في الخريطة المنشورة بشرط وجود عمود اسم وإحداثيات نقطة في الصف، وبحد 200 مكان للخريطة الواحدة. راجع الإجابات من أماكن الخريطة.
  • تُبلغ مكالمة جديدة بما يُسمح للمؤسسة برفعه. يعيد GET /shared-api/datahub/limits إمكانية رفع بيانات الأنشطة التجارية والخطة والحدود الخاصة بالمؤسسة. يعيد 200 في جميع الخطط، مع can_upload: false دون Enterprise. ويعرض قسم Studio الحدود نفسها في سطر واحد. راجع ما تستطيع المؤسسة رفعه.
  • رمز رفض الخطط غير المسموح لها بالرفع هو 403 vendor_data_not_on_plan. يحل محل الرمز المذكور سابقًا في هذه الصفحات، والذي لم يعد يُعاد. حدّث العملاء الذين يفحصون الرمز القديم.
  • يمكن إلغاء نشر إصدار وحذفه. يزيل POST /shared-api/datahub/releases/{id}/unpublish الإصدار المنشور من الخدمة فورًا، ويحذف DELETE /shared-api/datahub/releases/{id} الإصدار غير المنشور وكل ما نتج عنه. العمليتان متاحتان لمالكي المؤسسات ومسؤوليها في جميع الخطط، حتى بعد تخفيض الخطة. تعرض قائمة Releases في Studio الإجراءين Unpublish وDelete، أيضًا للمؤسسات التي غادرت Enterprise وما زالت تحتفظ بإصدارات. أُضيف الحقلان state وingest_id إلى القائمة. راجع سحب إصدار.
  • تُحذف الإصدارات القديمة تلقائيًا. يُحذف الإصدار الذي لم يعد حاليًا (بعد الاستبدال أو إلغاء النشر أو انتهاء معاينة) بعد 30 يومًا من فقدان حالته الحالية، ويُحذف الإصدار الفاشل بعد 30 يومًا من آخر محاولة معالجة. راجع مدة الاحتفاظ بالإصدارات.
  • يستهلك اقتراح تعيين الأعمدة رصيد AI. تُحاسب عملية POST /inference-api/vendor/mapping/propose من رصيد AI الخاص بالمؤسسة وتعيد 429 quota_exceeded عند نفاده. يبقى حد 30 اقتراحًا للحساب في الساعة؛ ويمكن تمييز استجابتي 429 المختلفتين من شكل الجسم. راجع التمييز بين استجابتي 429.
  • النطاق vendor متاح لـ Enterprise فقط. لا يمكن لمفاتيح Free وPro امتلاكه. طلب إنشاء مفتاح يحمل vendor ضمن هاتين الخطتين يعيد 403 tier_capability_not_allowed؛ سابقًا كانت Free تزيله بصمت، بينما سمحت Pro بإنشاء المفتاح. إذا جرى تدوير مفتاح كان يحمل vendor ضمن خطة أدنى من Enterprise فسيصدر المفتاح البديل بدونه. بعد الانتقال من Enterprise إلى خطة أقل، تتوقف المفاتيح الحالية عن الوصول إلى البيانات دون رسالة خطأ وتُنهي جلسات المتصفح المفتوحة. وتظل Pro توفر مفاتيح الخادم وعددًا أكبر من المفاتيح النشطة. راجع المصادقة والنطاقات.
  • تقبل الدردشة اللغة والعنوان والنص النائب. خيارات التثبيت الجديدة lang وtitle وplaceholder؛ وسمات العنصر lang وchat-title وplaceholder. عند غياب lang يستخدم اللوح قيمة <html lang> الصالحة في الصفحة وإلا فالإنجليزية. راجع مرجع Chat.
  • العنصر <kaleidr-map> كتلي افتراضيًا. يستخدم display:block ما لم تغيّره CSS، ولذلك تُطبّق قيمة height. سابقًا لم يعمل الارتفاع دون تحديد display:block كذلك. وتُبقي الأمثلة على display:block لدعم Safari قبل 16.4. راجع تحديد الحجم.
  • تُحفظ استدعاءات المقبض مباشرة بعد التثبيت. في Viewer وTile، إذا استُدعيت setCamera (أو setStyle في Tile) قبل أن تكون الخريطة داخل الإطار جاهزة، تُطبّق عند جاهزيتها، حتى آخر 256 استدعاء. سابقًا كانت تضيع. وإذا لم تُعلن الخريطة جاهزيتها خلال انتظار محدود، عادة بعد 10 ثوانٍ من تحميل الإطار، تُرسل الاستدعاءات المحفوظة مع تحذير واحد في وحدة التحكم. لم يعد انتظار kaleidr-embed:ready لازمًا قبل استخدام المقبض.
  • لا يقبل تجاوز عنوان CDN الأساسي سوى ثلاثة أنواع من المنشأ. يُحترم خيار وسمة base وwindow.__KALEIDR_EMBED_BASE__ فقط عند استخدام CDN الخاص بـ Kaleidr (https://cdn.kaleidr.com) أو المنشأ الذي حُمّل منه kaleidr.js أو منشأ الصفحة نفسها. تُتجاهل القيم الأخرى مع تحذير في وحدة التحكم ويُستخدم CDN الافتراضي. تظل الاستضافة الذاتية ممكنة إذا خُدم المحمّل والحزم من المنشأ نفسه. راجع إصدارات CDN.
  • تُحمّل نصوص المنتجات بترميز UTF-8 في كل صفحة. يستخدم المحمّل UTF-8 بغض النظر عن ترميز الصفحة المُعلن. سابقًا، في صفحة لا تصرح بالترميز، ربما فشل تثبيت Chat أو Editor وظهر chat.js loaded but window.KaleidrGeoChat is missing في وحدة التحكم. راجع استكشاف الأعطال.
  • إعادة التثبيت على العنصر نفسه بعد destroy() آمنة، حتى أثناء تحميل التثبيت الأول كما في الوضع الصارم لـ React.
  • الطلب المرفوض لا يحجز رصيدًا. الطلب الذي يُرفض قبل المعالجة بسبب حد المعدل أو التزامن أو خطأ التحقق أو كبر الجسم لم يعد يحتفظ برصيد AI أو خانة التزامن. راجع الحصص وحدود المعدل.
  • تأخذ إعدادات الكاميرا من صفحتك الأولوية في Viewer وTile. إعدادات التحميل (center أو zoom أو pitch أو bearing أو camera في عنوان iframe) أو إعدادات setCamera تتقدم على العرض المحفوظ من المؤلف، بما فيه العرض الملائم لعرض شاشة الزائر ومحتوى الخريطة، وتوقف إعادة التأطير التلقائية عند تغيير حجم النافذة. الحقول غير المقدمة تحتفظ بقيم المؤلف؛ ويُتجاهل zoom عند التحميل إن لم يُقدم center. راجع الكاميرا.
  • تحتفظ الدردشة على عنصر Viewer أو Tile بعلاماتها. كما في الخرائط الأخرى، تتراكم العلامات عبر الإجابات وتؤدي إعادة ذكر المكان بإحداثيات جديدة إلى نقل العلامة بدل إضافة أخرى. يؤدي إغلاق الدردشة أو تدميرها إلى إزالة العلامات والمسارات وكل ما رسمته. راجع الإمكانات والحدود.
  • title في الدردشة هو عنوان اللوح. يظهر العنوان الذي تحدده في رأس نافذة الدردشة لكل محادثة بمجرد بدئها. سابقًا كان يُستبدل بعنوان مستخرج من المحادثة. تعرض الدردشة المصغّرة عنوان محادثتها. راجع العنوان والنص النائب.
  • يستخدم Editor مفتاحك القابل للنشر للتعريف بطلبات الخريطة الأساسية. يرسل Editor المثبّت باستخدام kaleidr.js المفتاح القابل للنشر للصفحة إلى https://tile.kaleidr.com عند طلب النمط والصور الرمزية والخطوط. لا يوضع رمز الجلسة في عنوان URL إطلاقًا. لا توجد خيارات جديدة. راجع ما يعمل داخل صفحتك.

حدود API وحالات الرفض​

  • لطلبات بث الدردشة حدود ورموز خاصة. 422 too_many_messages وmessage_too_long وconversation_too_long وinvalid_session_id وlang_too_long. راجع نقاط النهاية.
  • بث الملخصات والأزرار يرفض الحقول الطويلة جدًا برمز 422 field_too_long.
  • جسم الطلب فوق 2 MiB (أو 5 MiB لنقاط التصميم) يُرفض برمز 413 request_too_large.
  • بث الدردشة الذي ينتهي دون إكمال يُحاسب على الأقل بحجم المحادثة التي أرسلها.
  • رمز الجلسة يرى معلومات أقل. استجابة 429 quota_exceeded وحدث البث quota لم يعودا يضمان الخطة أو الاستخدام أو الحد عند استخدام رمز جلسة.
  • قيد المنتج على مفتاح الخادم أو المفتاح القديم يُنفذ في كل طلب برمز 403 product_not_allowed.
  • رفع بيانات الأنشطة التجارية أُضيفت إليه حدود لكل حقل وقائمة والرموز 413 request_body_too_large و409 org_ingest_in_progress و429 ingest_rate_limited؛ ويشترط طلب اقتراح تعيين الأعمدة أن يكون صاحبه مالكًا أو مسؤولًا في مؤسسة مخولة بالرفع (Enterprise). راجع رفع بيانات الأنشطة التجارية.
  • رفع مجموعة بيانات في Kaleidr Studio فوق حد الخطة يُرفض برمز 402 quota_exceeded، وفوق الحد العام لجميع الخطط برمز 400 VALIDATION_ERROR. راجع الأخطاء.

تصحيحات هذه الصفحات​

يشير كل بند أدناه إلى موضع كان التوثيق فيه غير صحيح بينما لم يتغير المنتج.

رموز الأخطاء وحالاتها

  • تجاوز حصة رصيد AI يعيد 429 مع "error": "quota_exceeded". ذكرت الصفحات السابقة b2b.tokens_exceeded الذي لم تُعده API قط، كما أغفلت من الجسم detail وproduct وperiod.
  • لا يوجد رمز map_load_hard_stop. راجع «الخطط» أدناه.
  • تبادل الجلسة من منشأ خارج قائمة المفتاح يعيد 403 origin_not_allowed. كانت الصفحات السابقة تذكر session_origin_mismatch الذي يخص استخدام رمز جلسة من منشأ مختلف عن منشأ إصداره.
  • vendor_scope_requires_acknowledgement هو 422 وليس 403، ويخص المفاتيح القابلة للنشر فقط.
  • sessions_disabled هو 404 وsessions_not_configured هو 503. كان كلاهما موضحًا كـ 403.
  • تحمل استجابة 401 الجسم {"detail": "Invalid or missing API key"}. سابقًا قيل إن الجسم غير موجود.
  • يصل map_load_quota_exceeded كـ {"detail": "map_load_quota_exceeded"}. المثال المسطح السابق لم يكن موجودًا.
  • يعيد تعطل خدمة المفاتيح 401 وليس 503.
  • تمرير مفتاح إلى تضمين Viewer لا يؤدي إلى product_not_allowed؛ فـ Viewer لا يحتاج إلى مفتاح.
  • أُضيفت الرموز التي كانت غائبة، ومنها visitor_limit_reached وchat_disabled وnot_found وowner_has_no_organization وorg_admin_required وkey_not_found وkey_already_rotated.
  • key_already_rotated وkey_expired عند التعديل يخصان expires_at فقط؛ تظل حقول المفتاح الأخرى قابلة للتعديل. إلغاء مفتاح سبق إلغاؤه يعيد 200.
  • موضع رمز الرفض. في 403 أو 404 يوجد في detail. وفي 429 من API المنصة يوجد في error مع جملة توضيحية في detail، ما عدا map_load_quota_exceeded الذي يأتي في detail. راجع أشكال الاستجابة لرموز 429 في API الرفع.

تجد القائمة الكاملة في الأخطاء.

الخطط والحصص والمفاتيح

  • البيانات الخاصة في الإجابات وُصفت سابقًا بأنها متاحة «بدءًا من Pro». في الحقيقة إن استخدام بيانات الأنشطة التجارية في إجابات AI حصري لـ Enterprise، سواء رفعها أو نطاق vendor الذي يتيح قراءتها عبر API أو SDK. لدى Free وPro ميزة منفصلة هي مجموعات البيانات التي تُضاف إلى خريطة في Kaleidr Studio. راجع «تغييرات المنتج» أعلاه.
  • يتوقف تحميل الخرائط عند بلوغ الحصة في جميع الخطط. ذكرت الصفحات السابقة أن الخطط المدفوعة تستمر حتى خمسة أضعاف الحصة. هذا السلوك غير موجود. يمكن لحزمة تحميل خرائط زيادة الحد.
  • رصيد AI مجمع واحد لكل مؤسسة تشترك فيه مفاتيح API واستخدام فريقها لتطبيقات Kaleidr. سابقًا ذُكرت ميزانية شهرية منفصلة لرموز API.
  • دورة الحصة هي دورة الفوترة وليس دائمًا الشهر التقويمي.
  • حدود معدل الطلبات لكل مفتاح، والتزامن لكل مؤسسة. كان الادعاء بأن المفاتيح تشترك في حد المعدل خاطئًا.
  • قائمة المناشئ المسموحة اختيارية للمفتاح القابل للنشر. اشترطت صفحة سابقة منشأ واحدًا على الأقل لمفتاح الإنتاج؛ أما القائمة الفارغة فتعني السماح بجميع المناشئ.
  • لا يمكن تعديل النطاقات بعد إنشاء المفتاح. كانت الصفحات التي وصفت تحريرها أو حذفها خاطئة؛ أنشئ مفتاحًا جديدًا وألغِ القديم.
  • تُرسل مفاتيح الخادم والمفاتيح القديمة مباشرة في استدعاءات التشغيل. ادعت صفحة سابقة أن كل استدعاء يحتاج رمز جلسة.
  • تدوير المفاتيح في Free. يحصل المفتاح القابل للنشر الذي يُدوّر في Free على جميع إمكانات Free (ai وmaps وdesign، والمنتجات الأربعة)، بغض النظر عن نطاقات المفتاح القديم. يُرفض تدوير مفتاح خادم أو قديم في Free برمز 403 free_plan_publishable_only.
  • monthly_cap_tokens: القيمة 1 أو أكبر تضع حدًا؛ و0 أو null تعني بلا حد.
  • org_id عند إنشاء المفتاح يجب أن يكون ضمن جسم JSON. لا يُقرأ org_id في الاستعلام إلا في مسارات المفاتيح الأخرى.
  • يحتسب Visitor AI Chat كل طلب. السؤال يستهلك طلبًا واحدًا للإجابة إضافة إلى طلب صور لكل بطاقة نتيجة. فتح بطاقة مكان أو سؤال متابعة أو بحث عنوان في الاتجاهات أو حساب مسار يُنشئ طلبات أخرى تُحتسب جميعها في حد الزائر. راجع الدردشة على خريطة منشورة.

راجع الحصص وحدود المعدل والمصادقة والنطاقات.

البث المتدفق

  • حدث quota هو آخر حدث في البث، بعد end أو error. وُصف سابقًا بأنه يصل أثناء البث. يبلغ عن الاستخدام لكنه لا يستطيع التحذير قبل النهاية.
  • قد يصل حدث place دون إحداثيات مع unverified: true.
  • لا يحمل حدث error الحقل code إلا في حالة upstream_stall.
  • أُدرجت أحداث البطاقات والطبقات التي يبثها النظام، مثل weather_card وbuilding_card وarrivals_card وغيرها.
  • أصبحت تدفقات الملخصات والأزرار موثّقة.
  • حدث quota الخاص برمز الجلسة يحمل فقط type وmeter وreset_at. عرض مثال سابق أرقام الاستخدام التي تُرسل إلى مفتاح الخادم وحده.
  • يكرر end خمسة أحداث للبطاقات والطبقات وليس جميعها: weather_card وsatellite_card وconstellation_layer وweather_layer وvehicles_layer.

راجع مواصفات نقل SSE.

نقاط النهاية

  • كانت أجسام الطلبات لـ POST /design/analyze وPOST /design/apply-direct غير صحيحة؛ أعاد مثال التحليل القديم 422. صُحح الاثنان وتُعرض استجابات الكتالوج مع المفتاح الخارجي الذي يحتويها.
  • يقبل POST /chat/control/route الحقلين lat وlng مباشرة في كل مكان، لا داخل coordinates.
  • تُتجاهل رسائل system المرسلة إلى POST /chat/control/stream. لم يكن ذلك موضحًا.

راجع نقاط النهاية.

الخرائط المنشورة وروابط المشاركة

  • تعرض الخريطة المنشورة الحالة المحفوظة حاليًا. قالت الصفحات القديمة إن التضمين يعرض «آخر نسخة منشورة» وإن Re-publish يحدّثها. في الواقع، أي تعديل يُحفظ في Studio، بما فيه إضافة مجموعة بيانات، يصبح عامًا في التحميل التالي للتضمين دون إعادة النشر. يسجل Re-publish نسخة منشورة جديدة مع إبقاء المعرّف والرابط ورمز التضمين كما هي. لتعديل خريطة بخصوصية، ألغِ نشرها أولًا ثم أعد نشرها بعد الانتهاء. راجع تضمين خريطة.
  • لا يمكن حذف روابط المشاركة أو إيقافها مؤقتًا في Studio. يؤدي فتح مربع Share إلى نشر الخريطة وإنشاء رابط جديد في كل مرة. الرابط لقطة لتصميم الخريطة ويستمر بعد إلغاء نشرها حتى تُحذف الخريطة أو تزيل Kaleidr الرابط بناءً على الطلب. كانت الصفحات السابقة تصف أدوات حذف أو إيقاف غير متوفرة. راجع روابط المشاركة.

SDK وعمليات التضمين

  • تتحكم الدردشة في حركة الخريطة. ادعت الصفحات السابقة أنها لا تحرك الكاميرا. لكنها تنتقل إلى الأماكن الواردة في الإجابة وتضبط نطاق العرض وتضيف علامات وترسم مسارات. فقط setCamera في مقبض تثبيت الدردشة غير مدعوم.
  • نطاق Editor. يعمل المحرر المضمن داخل الصفحة ويحتفظ بالعمل في ذاكرتها. لا يحفظ ولا يصدر ولا ينشر ولا يستدعي API التصميم. كانت الصفحات التي وصفت النشر من التضمين خاطئة.
  • مضيفو سياسة أمان المحتوى. يحمّل Editor الخريطة الأساسية من https://tile.kaleidr.com، وهو مضيف كان غائبًا عن صفحة السياسة. لا تتصل أي تضمينات افتراضيًا بمضيف خرائط تابع لجهة خارجية. تحمل الدردشة أيقونات المواقع التي تستشهد بها الإجابة عبر خدمة favicon من Google، وأصبحت هذه الخدمة مدرجة في صفحة السياسة والإمكانات والحدود.
  • أُعيد توثيق Leaflet كخريطة مدعومة للدردشة إلى جانب Mapbox GL JS وMapLibre GL JS وGoogle Maps JavaScript API.
  • عنوان URL لإطار Tile لا يحمل بيانات اعتماد. لا يحتوي إلا على معرّف النمط والكاميرا، دون مفتاح قابل للنشر أو رمز جلسة. يتحقق تبادل جلسة Tile من المفتاح ويحتسب تحميل الخريطة ويعيد الخريطة الأساسية الافتراضية للمؤسسة؛ ولا يستخدم إطار الخريطة بيانات الاعتماد لإجراء أي مكالمة. راجع مرجع Tile.
  • Kaleidr.enable(false) يوقف التثبيتات التي تحدث بعد الاستدعاء فقط. إذا كان المتصفح قد قرأ عنصر <kaleidr-map> قبل تشغيل المحمّل فسيُثبّت فورًا قبل استدعائك. اضبط علامة الصفحة window.__KALEIDR_EMBED_ENABLED__ = false قبل المحمّل.
  • استدعاء Kaleidr.mount دون كائن خيارات يرمي TypeError. أي فشل تثبيت آخر يسجل خطأ واحدًا في وحدة التحكم يحوي [kaleidr:<product>] (يظهر بشكل Error: [kaleidr:…) ولا يرمي استثناء.
  • شريط أدوات Editor المضمن يضم Text وImage وMarker وPopup وBackground وLayer وDesign وLegend. كانت الصفحات السابقة تزعم غياب Design، بينما ما يغيب فعلًا هو كتالوج تصميم Studio وعلامة تبويب Data ولوحة AI ومكتبة النماذج ثلاثية الأبعاد.
  • يعرض kaleidr-plain مباني ثلاثية الأبعاد بدءًا من مستوى التكبير 15. سبق وصفه بأنه لا يحتوي عليها.
  • يرسل Tile بلا نمط وبلا نمط افتراضي للمؤسسة حدث kaleidr-embed:error مع code: 'no_id' وid: null.
  • يقبل shareId في Viewer معرّف خريطة منشورة أو المعرّف ذي 16 حرفًا لرابط مشاركة. أما دردشة الخريطة المنشورة فتقبل معرّف الخريطة نفسها فقط.

صفحات جديدة​

2026-10​

  • تفاصيل أكثر عن كل نتيجة عنوان. أصبحت نتائج GET /retrieval/geocode/forward لعنوان شارع تتضمن id، وهو معرّف Kaleidr لذلك المدخل ويظل ثابتًا عبر تحديثات البيانات. ويتضمن العنوان التقديري within_m وscore بجوار method وmatched_numbers. يمكن أن تكون method بقيمة "range"، أي رقم منزل أمريكي موضوع على امتداد المربع السكني الذي يتبعه. هذه إضافات فقط. راجع نقاط النهاية.
  • مفاتيح API في خطة Free. أصبح المفتاح القابل للنشر لمؤسسة Free يدعم الدردشة الذكية والخرائط المنشورة والمحرر إلى جانب الخرائط الأساسية (النطاقات ai وmaps وdesign وجميع المنتجات)، مع استهلاك رصيد AI لخطة Free. تتطلب مفاتيح الخادم Pro أو Enterprise. (النطاق vendor حصري لـ Enterprise منذ 2026-10-13.) الحدود الحالية للمفاتيح النشطة لكل مؤسسة: Free مفتاحان، Pro عشرة، Enterprise خمسة وعشرون (409 key_limit_reached؛ لا يُحتسب التدوير وتظل المفاتيح الموجودة فوق الحد محفوظة).

2026-09​

  • عناوين الشوارع في البحث عن العناوين. يعيد GET /retrieval/geocode/forward أيضًا عنوان شارع مكتوبًا (type: "address"). تحدد attribution.sources مجموعات بيانات العناوين المستخدمة مع الإسناد وأي تقييد يفرضه الترخيص؛ ولا يجوز استخدام نتائج G-NAF لإعداد قوائم عناوين بريدية. يُقدَّر رقم المنزل غير الموجود من أقرب أرقام في الشارع ويُوسم بـ approximate: true وmethod وmatched_numbers. هذه إضافة ولا تتغير نتائج الأماكن السابقة.
  • اتجاهات النقل العام. يقبل POST /chat/control/route القيمة profile: "transit" ويعيد رحلة تتضمن وسيلة نقل واحدة في action.payload.transit، أو { "error": "…" } إذا لم تتوفر رحلة مباشرة. جسم الطلب ثابت والقيم الأخرى لـ profile تتصرف كما في السابق. يخدم GET /retrieval/geocode/forward الجديد (نطاق ai، مدفوع) البحث عن نقطة الانطلاق والوجهة. اكتسبت شاشة الاتجاهات في الدردشة حقلي إدخال «من/إلى» ووضع النقل العام.
  • تتبع إمكانات المفتاح الخطة الحالية. يتحقق تبادل الجلسة وكل استدعاء تشغيلي من المفتاح وفق خطة المؤسسة في تلك اللحظة، فتسري تغييرات الخطة دون تعديل المفاتيح أو تدويرها. يعني tier_capability_not_allowed أن المفتاح يمتلك الصلاحية لكن الخطة لم تعد تشملها، ويعني insufficient_scope أنه لم يمتلكها أصلًا.
  • تؤثر تغييرات الخطة على الجلسات الصادرة. يؤدي تخفيض الخطة إلى إنهاء الجلسات السابقة خلال دقائق بدل انتظار انتهاء صلاحيتها. وتسري الترقية من تبادل الجلسة التالي.
  • تُفحص تعديلات المنتجات في Free. تغيير allowed_products لمفتاح Free إلى قائمة فارغة أو منتج خارج الخطة يعيد 403 tier_capability_not_allowed.
  • أُزيل حدث البث grounding. لم يعد العملاء الذين كانوا يستمعون إليه يتلقونه.

2026-08​

  • يتطلب الوصول إلى الخريطة الأساسية مفتاحًا. الاستخدام المباشر لـ tile.kaleidr.com من جهات خارجية مقيّد؛ أما تضمينات <kaleidr-map> والخرائط المستضافة من Kaleidr فلا تتأثر. تُحتسب جلسات Tile ضمن تحميلات الخرائط للمؤسسة (الحصة).
  • تبادل الجلسات وتجديدها. تُستبدل المفاتيح القابلة للنشر بجلسات قصيرة العمر مرتبطة بالمنشأ (kld_sess_…، 15 دقيقة) ويجددها SDK.
  • يمكن للدردشة التحكم بعنصر خريطة Kaleidr. يمكن أن يشير تثبيت الدردشة عبر map-target إلى عنصر Viewer أو Tile على الصفحة نفسها.
  • الخريطة الأساسية الافتراضية للمؤسسة. يعيد POST /sdk/sessions الخريطة الأساسية الافتراضية ضمن basemap_style_id، ويستخدمها التضمين الذي لا يحدد نمطًا.
  • تُرفض مفاتيح الخادم في المتصفح. يرفض SDK المفتاح kld_sk_… عند التثبيت.
  • فصل خيارات العنوان الأساسي. فُصل viewerBase وtileBase عن خيار المحمّل base.
  • ألوان المسار. يحمل حدث البث route الحقول color وlabel وalternatives وcomparison.

v1​

  • محمّل kaleidr.js والعنصر <kaleidr-map>: محمّل واحد لأربعة منتجات (Chat وViewer وEditor وTile).
  • مفاتيح المتصفح القابلة للنشر (kld_pk_) ومفاتيح الخادم (kld_sk_) مع النطاقات ai وmaps وdesign وvendor؛ تُستبدل المفاتيح القابلة للنشر بجلسات قصيرة مرتبطة بالمنشأ. وتظل المفاتيح القديمة kld_live_ تعمل.
  • عائلات نقاط النهاية /inference-api/b2b/v1/chat/* (بث) و/design/*.