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

Chat — إرفاق الذكاء الاصطناعي بخريطتك

يقوم product="chat" بتركيب Kaleidr Control Tower — للتنقل عبر الدردشة، وملخصات نقاط الاهتمام، ودبابيس الأماكن — فوق خريطة أنت تعرضها بالفعل. تكتشف حزمة chat مزود الخريطة تلقائيًا (Mapbox، MapLibre، Google).

  • طريقة الدمج: attach — يتم تركيب اللوحة داخل صفحتك وتتحكم في كائن الخريطة الذي تمرره إليها.
  • النطاق المطلوب: ai.
  • الحد الأدنى للخطة: Pro — مفاتيح Free لا تسمح بنطاق ai.

قبل البدء​

  • يجب أن يكون أصل صفحتك ضمن قائمة الأصول المسموح بها للمفتاح. وإلا يفشل تبادل الجلسة بخطأ 403 session_origin_mismatch. لا يرسل file:// أي Origin ويفشل دائمًا — استخدم HTTP(S). راجع الحصول على مفتاح API.
  • يجب أن يسمح CSP الخاص بك بمحمّل SDK، و'wasm-unsafe-eval' الخاص بـ MapLibre، ومضيفي مزود الخريطة — راجع Content Security Policy.

التركيب​

const handle = Kaleidr.mount('#chat-panel', {
  product: 'chat',
  publishableKey: 'kld_pk_live_…',   // ai scope, Pro+
  map: myMap,                         // your live map instance
  contained: true,                    // dock inside #chat-panel, not on body
});

contained: true يثبت اللوحة داخل عنصر التركيب. وبدونه تخرج اللوحة إلى document.body وتبدو معطلة فوق تخطيط الصفحة.

تضع لوحة chat الأماكن على myMap وتضبط إطار الكاميرا بينما تحدد المحادثة المواقع. يستخدم البث SSE wire contract؛ ويتم احتساب الاستخدام لنطاق ai من حصة مؤسستك.

Handle​

handle.destroy();                     // always available
handle.setTheme({ '--kd-accent': '#2da84a' });  // live theme update
  • handle.setCamera(...) في chat هي no-op. لا يتحكم Chat في كاميرا الخريطة — استخدم API الكاميرا الخاص بمثيل الخريطة لديك.
  • يقبل handle.setTheme(...) كائن JSON لرموز CSS؛ ويتم تجاهل السمات النصية المسماة مع تحذير.

يتم دعم الوضع Headless (بدون خريطة) — احذف map للحصول على لوحة chat فقط؛ لن تكون هناك دبابيس أو تراكبات للمسارات.

أدلة المزودين​