تربط حزمة تطوير خرائط الذكاء الاصطناعي بين الذكاء الاصطناعي وتجربة خريطة وظيفية عبر مكوّنات واجهة المستخدم وأحداث الأماكن المنظَّمة وإجراءات الخريطة ومصادقة آمنة للمتصفح. يظل عارض الخريطة مسؤولاً عن العرض، بينما تبقى الأنظمة الموثوقة مسؤولة عن السجلات الواقعية. اختر هذه الحزمة عندما يحتاج المنتج إلى تفاعل حواري مع الخريطة أو مكوّنات مكانية مضمنة أو مسار أسرع من مخرجات الذكاء الاصطناعي إلى إجراء جغرافي مرئي.
تتناول الأقسام التالية مسؤوليات المكوّنات والبنية ومسارات تكامل Kaleidr والحدود الأمنية ومعايير التقييم والأخطاء الشائعة. للاطلاع على شرح عملي للتركيب، راجع كيفية إضافة دردشة الذكاء الاصطناعي إلى خريطة. أما طبقة الاسترجاع التي تعمل أسفل الحزمة، فراجع ما واجهة برمجة معلومات الموقع؟.
أساسيات حزمة تطوير خرائط الذكاء الاصطناعي
- طبقة تكامل المنتج: تربط واجهة المضيف واستدلال الذكاء الاصطناعي والجغرافيا المنظَّمة والعارض الحي؛ وليست مجرد روبوت محادثة.
- أحداث منظَّمة: استخدم أغلفة المكان والإجراء والاستناد إلى المصادر والحصة والنهاية والخطأ بدلاً من استخراج الإحداثيات من النص.
- فصل بيانات الاعتماد: مفاتيح قابلة للنشر ومقيّدة بالمصدر في المتصفح؛ ومفاتيح الخادم في الواجهة الخلفية للمضيف فقط.
- محوّل المزوّد: اتصل بـ Mapbox أو Google Maps أو MapLibre أو Leaflet من دون استبدال العارض عندما يدعم المنتج ذلك.
- مرجعية البيانات: يفسّر الذكاء الاصطناعي المقصد؛ وتتحقق أنظمة المواقع والأعمال المعتمدة من الحقائق.

لمحة عن حزمة تطوير خرائط الذكاء الاصطناعي
تقع خريطة الذكاء الاصطناعي SDK بين تطبيق المضيف ومزود الخريطة والأنظمة التي توفر حقائق الموقع.يجب ألا يصبح SDK المصدر الواقعي للعناوين أو حالة الإدراج أو المخزون أو ساعات العمل أو الطرق أو السجلات التجارية الخاصة.مبدأ الإنتاج الموثوق هو أن الذكاء الاصطناعي يفسر النية الجغرافية ، والأنظمة الموثوقة تحقق من صحة الحقائق ، و SDK يحول النتائج المعتمدة إلى سلوك خريطة مرئي.
| المكون | المسؤولية الرئيسية |
|---|---|
| تطبيق المضيف | المستخدمون والجلسات وسياق المستأجر والأذونات وسير العمل ومنطق العمل |
| خريطة الذكاء الاصطناعي SDK | مكونات واجهة المستخدم ، تسليم النية ، المصادقة ، البث ، إجراءات الخريطة المنظمة ، ودورة الحياة |
| معرض الخرائط | الكاميرا، الطبقات، العلامات، الضوابط، النمط، والسلوك الخاص بالمزود |
| منصة API | الاستدلال، أو استرجاع المكان، أو التوجيه، أو التصميم، أو الترتيب، أو غيرها من الخدمات الموثقة |
| خدمات الموقع | الترميز الجغرافي والأماكن والطرق والحدود والبلاط والسياق المكاني |
| نظم الأعمال | المخزون الموثوق والممتلكات والأصول والعملاء والأهلية والسجلات التشغيلية |
| التحليلات | الأسئلة والنتائج وإجراءات الخرائط والأخطاء وإتمام المهام ونتائج المنتج |
ماذا تفعل حزمة تطوير خرائط الذكاء الاصطناعي فعلياً؟
يعتمد النطاق الدقيق على النظام الأساسي ، ولكن خريطة الذكاء الاصطناعي القادرة على SDK عادة ما تتعامل مع سبع وظائف منسقة.أولاً ، يربط SDK إخراج الذكاء الاصطناعي بكائن خريطة حية يعمل بالفعل في التطبيق.تعرض كل من Mapbox GL JS و Google Maps JavaScript API و MapLibre GL JS كائنات الخرائط القابلة للبرمجة باستخدام الكاميرا والحدود والحدث وطرق التقديم ؛ يحتاج SDK إلى محول مزود بحيث يمكن أن يصبح أحد الإجراءات المنظمة هو العملية الصحيحة الخاصة بالمزود - إطار منطقة النتيجة ، أو مقلاة إلى مكان ، أو إضافة علامات ، أو تسليط الضوء على ميزة ، أو عرض مسار ، أو الحفاظ على السياق الجغرافي.يقبل مرفق الدردشة الحالي في Kaleidr مثيل خريطة حي ودعم المستندات لـ Mapbox وخرائط Google و MapLibre و Leaflet من خلال مرفق الدردشة SDKفي حين يواصل المزود الحالي عرض الخريطة.
ثانياً، يحوّل SDK مخرجات الذكاء الاصطناعي إلى أحداث جغرافية منظَّمة بدلاً من إجبار المضيف على استخراج الأماكن المهمة من النص. يفصل العقد الجيد بين النص المتدفق والأماكن المحلولة والبيانات الوصفية المعززة وإجراءات الخريطة ومصادر الاستناد والحصة وحالة النجاح أو الخطأ النهائية. يتضمن عقد الأحداث المرسلة من الخادم لدى Kaleidr أحداث place وplace_linked وearly_actions وgrounding وquota وend وerror؛ ويُعد حدث end الغلاف النهائي الموثوق. لا يحتاج مستخدمو kaleidr.js إلى تحليل التدفق يدوياً، ويمكن لمن يبني عميلاً مخصصاً اتباع عقد SSE الموثّق. كما توثّق MDN نموذج الأحداث المرسلة من الخادم في المتصفح.

ثالثًا ، يمكن أن يوفر SDK مكونات واجهة المستخدم القابلة لإعادة الاستخدام - لوحة دردشة أو مشاهد أو محرر أو تحكم في البحث أو عنصر مخصص - بحيث لا يقوم كل فريق بإعادة بناء الواجهة. مكونات الويب دعم عناصر HTML المخصصة القابلة لإعادة الاستخدام ؛ يقوم محمل Kaleidr بتثبيت كل من window.Kaleidr للتركيب الحتمي وعنصر <kaleidr-map> للتضمين التصريحي عبر منتجات الدردشة والمشاهد والمحرر وخاصية القاعدة (مرجع kaleidr.js, عنصر <kaleidr-map>)
رابعاً ، يجب أن تميز المصادقة الآمنة للمتصفح بيانات الاعتماد القابلة للنشر ، وبيانات اعتماد الخادم ، والأصول المسموح بها ، والجلسات قصيرة الأجل ، ونطاقات القدرات ، والإلغاء ، والحصص.يستخدم Kaleidr مفاتيح قابلة للنشر (kld_pk_live_…) لمتصفح SDK ومكونات الويب - مقيدة بالأصول المعتمدة ومبادلتها بجلسة قصيرة الأجل - ومفاتيح الخادم (kld_sk_live_…) التي يجب أن تبقى خارج HTML و JavaScript للمتصفح وحزم العملاء والمستودعات العامة.تفصل نطاقات القدرة بين عائلات مسارات ai و maps و design ؛ مفتاح صالح بدون النطاق اللازم يعود 403 ، في حين أن 401 إرجاع الاعتماد غير الصالح أو الملغى.انظر المصادقة والنطاقات و الأصول المسموح بها.
خامسًا ، تقوم SDK بتطبيع اختلافات دورة الحياة ومزود الخدمة: قد لا يكون كائن الخريطة موجودًا بعد ، وقد تفتقر الحاوية إلى الارتفاع ، وقد لا يزال النمط قيد التحميل ، أو قد يغير تطبيق من صفحة واحدة الطرق ، أو قد يتمكّن المكون من التثبيت أثناء نشاط التيار.يعيد محمل Kaleidr مقبضًا بشكل متزامن بينما يتم تحميل حزمة المنتج المحددة في الخلفية ؛ يتم وضع المكالمات التي تتم قبل أن تكون الحزمة جاهزة في قائمة الطبور ، ويعرض المقبض destroy() من أجل التمزقيحافظ سلوك التركيب والتدمير المتوقع على تغييرات مسار SPA والصفحات متعددة المالات من تسرب المستمعين أو أسطح الدردشة المكررة.
سادساً ، يربط SDK مكونات المتصفح بواجهات برمجة التطبيقات الأساسية دون الخلط بين الاثنين. SDK هي طبقة التكامل التي تواجه التطبيق لواجهة المستخدم ، وتبادل الجلسة ، وتحلل التيار ، ومرفق الخريطة.تعرض واجهة برمجة التطبيقات الاستدلال الذي يمكن الوصول إليه من الخادم ، والاسترجاع ، والتوجيه ، والتصميم ، والطرق ذات الصلة تحت https://api.kaleidr.com/inference-api/b2b/v1/ (مرجع نقطة النهاية)
سابعاً، يقوم عقد منتج مستقر بإجراء إجراءات مدعومة، وكائنات خرائط يتم التحكم فيها، والمفاتيح والنطاقات المطلوبة، والأخطاء، والأحداث، والتمزيق، والإصدار، وسلطة البيانات، والقياس الصريح.تقوم دبابيس Kaleidr بتضمين الأصول تحت /embed/v1/ وتتطلب مسارًا رئيسيًا جديدًا لكسر التغييرات في الأسلاك (إصدار CDN)هذا العقد هو ما يتيح لتطبيقات الاستضافة ترقية اللودر دون تغيير هندسة سلوك واجهة المستخدم غير الموثق.
كيف تختلف عن واجهة الخرائط أو نظم المعلومات الجغرافية؟
هذه المصطلحات ذات صلة ولكن لا ينبغي التعامل معها كمرادفات.ترسم مكتبة الخرائط أو المعرض الخريطة وتتحكم في الكاميرا والطبقات وأحداث الخرائط.توفر واجهة برمجة تطبيقات الخرائط أو الموقع بيانات جغرافية أو عمليات بعيدة مثل الترميز الجغرافي أو الأماكن أو الطرق أو البلاط.تنتج واجهة برمجة تطبيقات AI استنتاجًا أو إخراج نموذج.توفر خريطة الذكاء الاصطناعي SDK تكامل المنتج عبر الذكاء الاصطناعي وحالة الخريطة والمصادقة ووادي العمل والإجراءات المنظمة.تغطي منصة نظم المعلومات الجغرافية إدارة البيانات والتحليل والتحرير والنشر والحوكمة على نطاق أوسع.يمكن لمعرض العرض عرض خريطة دون فهم هدف اللغة الطبيعية للمستخدم ؛ يمكن لواجهة برمجة تطبيقات الذكاء الاصطناعي تفسير جملة دون معرفة كيفية التحكم في الخريطة على الصفحة ؛ يربط SDK تلك الأنظمة من خلال عقد تطبيق موثق.

| الفئة | ماذا يوفر | مثال المسؤولية |
|---|---|---|
| مكتبة الخرائط أو المعرض | كائن الخريطة ومحرك التقديم المرئي | ارسم الخريطة ، كاميرا التحكم ، أضف طبقات ، تعامل مع أحداث الخريطة |
| خريطة أو موقع API | البيانات أو العمليات الجغرافية البعيدة | Geocode ، ابحث عن مكان ، احسب طريقًا ، إرجاع البلاط |
| AI API | الاسدل أو إخراج النموذج | تفسير سؤال، وتوليد النص، وتصنيف النية |
| خريطة الذكاء الاصطناعي SDK | تكامل المنتج عبر الذكاء الاصطناعي، وحالة الخريطة، والأوث، واجهة المستخدم، والإجراءات | إرفاق الدردشة، تدفق الأماكن، وتطبيق إجراءات الخريطة، وإدارة دورة الحياة |
| منصة نظم المعلومات الجغرافية | إدارة البيانات، التحليل، التحرير، النشر، الحوكمة | الحفاظ على طبقات موثوقة ، وتشغيل التحليل المكاني ، وإدارة السجلات |
كيف تعمل البنية الأساسية؟
تتبع حزمة تطوير خرائط الذكاء الاصطناعي في بيئة الإنتاج عادةً تدفقاً واضحاً: يطرح المستخدم سؤالاً أو يصدر التطبيق حدثاً؛ ويوفّر المضيف السياق والأذونات؛ وتنسّق الحزمة جلسة المتصفح أو استدعاءات الواجهة الخلفية؛ ثم تعيد واجهات الاستدلال أو الاسترجاع أو التوجيه أو التصميم أماكن منظَّمة ومصادر استناد وإجراءات مسموحاً بها؛ ويترجم محوّل المزوّد النتائج؛ فتتحدّث الخريطة الحية أو العارض أو المحرر أو خريطة الأساس المصممة. يظل تطبيق المضيف مسؤولاً عن المستخدم المسجّل وسياق المستأجر والأذونات ومجموعات البيانات المعتمدة واسترجاع البيانات الخاصة والإجراءات التجارية المؤثرة والاحتفاظ والسجلات والتعافي النهائي من الأخطاء. ويجب ألا تتجاوز الحزمة هذه الضوابط.
يتطلب الوعي بالخريطة قراءة السياق الجغرافي أو تلقيه، بما في ذلك المركز ومستوى التكبير والحدود المرئية والأماكن المحددة والطبقات النشطة والهندسة المرسومة والمرشحات واللغة والمنطقة. وينبغي أن يعيد النظام نتائج جغرافية منظَّمة مثل الإحداثيات ومعرّفات الأماكن الثابتة والهندسة والحدود وهندسة المسار ونوع الإجراء والمصدر والثقة وحالة واضحة لعدم وجود نتيجة أو للخطأ. استخدم عقد إجراءات بقائمة سماح بدلاً من السماح للنموذج بإنشاء JavaScript عشوائي أو استدعاءات غير مقيّدة للمزوّد. توضّح أشكال مفاهيمية مثل fit_bounds مع حقول الغرب والجنوب والشرق والشمال الفكرة؛ واستخدم دائماً الأشكال الدقيقة التي توثّقها المنصة المختارة.
كيف تدمج حزمة Kaleidr؟
قم بتحميل محمل Kaleidr الحالي مرة واحدة من مسار CDN المعلن بالإصدار https://cdn.kaleidr.com/embed/v1/kaleidr.js قبل تركيب منتج.بالنسبة للتطبيق الذي يمتلك بالفعل مثيل خريطة حية مدعومًا ، ضع الخريطة وحاويات الدردشة في الصفحة ، ثم قم بتركيب الدردشة مع واجهة برمجة التطبيقات الحتمية بعد وجود كائن الخريطة الحية:
// myMap must be a live Mapbox, Google Maps, MapLibre,
// or other currently supported map instance.
const chatHandle = Kaleidr.mount("#map-chat", {
product: "chat",
publishableKey: "kld_pk_live_REPLACE_ME",
map: myMap,
enabled: true
});
// Keep the handle for cleanup in an SPA or component lifecycle.
window.addEventListener("beforeunload", () => {
chatHandle.destroy();
});
المثال مقتبس من Kaleidr الحالي البداية السريعة و لودر مرجع.يجب أن يقوم التطبيق بتهيئة myMap قبل الدردشة المتصاعدة.يجب أن يتضمن المفتاح القابل للنشر نطاق ai ، ويجب أن يظهر أصل التطبيق في قائمة الأصل المسموح به للمفتاح.تستخدم خريطة Kaleidr المنشورة مسار العارض التصريحي مع <kaleidr-map product="viewer" share-id="…"> ؛ العارض هو بوابة رابط المشاركة ولا يتطلب حاليًا أي مفتاح API ، على الرغم من أن النطاقات المسموح بها المحددة للناشر لا تزال تنطبق (تضميم المشاهد)
متى تستخدم الفرق الحزمة بدلاً من واجهة المنصة؟
استخدم SDK عندما يريد تطبيق المضيف مكون دردشة أو مشاهدًا أو محررًا أو خريطة أساس مدعومة ؛ تبادل تلقائي لجلسة المتصفح ؛ مرفق مزود UI ؛ مرفق مزود قابل لإعادة الاستخدام ؛ تحليل البث ؛ معالجة دورة الحياة ؛ ووقت أسرع للتنفيذ.استخدم واجهة برمجة تطبيقات المنصة مباشرة عندما تحتاج الواجهة الخلفية للمضيف إلى واجهة مستخدم مخصصة أو ترسيخ من جانب الخادم أو استرجاع البيانات الخاصة قبل الاستدلال أو التحكم الكامل في العرض أو عميل غير متصفح أو الوصول المباشر إلى عائلات الطرق الموثقة أو تسجيل الدخول والسياسة المخصصة.غالبًا ما يكون التنفيذ الهجين أقوى: SDK لواجهة المستخدم للمتصفح وتفاعل الخريطة ، والواجهة الخلفية للاستضافة للترخيص والاسترجاع الخاص ، وواجهة برمجة تطبيقات المنصة لسير عمل الخادم المتحكم فيه.لا تنقل مفتاح خادم إلى رمز المستعرض ؛ احتفظ ببيانات اعتماد الخادم على الواجهة الخلفية واتصل بنقاط نهاية البث الموثقة من البيئات الموثوقة فقط (نقاط النهاية)
كيف تستند الفرق إلى البيانات وتحمي المفاتيح؟
الخريطة تجعل الإجابة تبدو دقيقة حتى عندما تكون الحقيقة الأساسية ضعيفة.وتشمل المخاطر الشائعة الأماكن المفبركة، والإحداثيات غير الصحيحة، والوضع التجاري العتيق، ومطالبات الطرق غير المدعومة، وتضارب أسماء الأماكن، والكيانات المكررة، والنتائج خارج الجغرافيا المقصودة، والملخصات التي تتعارض مع الأنظمة الخاصة.يفضل هذا التسلسل: نية اللغة الطبيعية ، استرجاع أو دقة مكان مصرح بها ، كائن جغرافي منظم ، عمل خريطة مسموح به ، ثم إجابة مرئية مع سياق المصدر.حل الأماكن المهمة للمعرفات المستقرة ، والحفاظ على مصدر وتحديث الوقت للسمات الحرجة ، والحفاظ على الأنظمة الداخلية موثوقة للحقائق التشغيلية ، وعرض حالات عدم النتيجة والغموض ، وتتطلب تأكيدًا للتعديلات التبعية ، وتقييد الاسترجاع الخاص من قبل المستخدم والمستأجر ، ومعاملة النتيجة النهائية المنظمة كعقد التطبيق.

تتضمن قواعد المتصفح استخدام مفتاح قابل للنشر مصمم لاستخدام المتصفح ، وتقييد المفتاح لإنتاج أصول الإنتاج والتدريج الدقيقة ، واستخدام HTTPS خارج التطوير المحلي ، وتدمير تكامل SDK عندما يتغير المسار أو المستأجر ، وعدم كشف السجلات الخاصة لمجرد أن الخريطة تحتاج إلى علامة.تتضمن قواعد الواجهة الخلفية الاحتفاظ بمفاتيح الخادم في مدير الأسرار ، وإنفاذ التفويض قبل الاسترجاع ، والحد من الحقول التي تم تمريرها إلى الاستدلال ، والتعامل مع 401 ، و 403 ، و 422 ، 429 ، واستجابات 503 العابرة بشكل واضح ، ومعالجة حدث SSE error الطرفي كنهاية للتدفق ، وتدقيق الوصول الحساس.يحتفظ Mapbox وخرائط Google ومقدمو بلاط MapLibre والخدمات الأخرى ببيانات الاعتماد الخاصة بهم وشروطهم وإسنادهم وفواتيرهم وحصصهم ؛ لا يحل مفتاح Kaleidr محل بيانات اعتماد مقدم الخريطة.تقوم Kaleidr بتوثيق مسارات CDN المعلبة بالإصدار ، وقياس الاستخدام على مستوى المنظمة ، والحصص المشتركة عبر مفاتيح المؤسسة ، وأحداث quota خلال البث (حدود الحصص والسعر)
كيف تقيّم حزمة تطوير خرائط الذكاء الاصطناعي؟
تأكيد توافق المزود - المزودون والإصدارات المدعومة ، سواء كان SDK يحتاج إلى كائن خريطة أو محدد CSS ، سواء كان يمتلك الخريطة أو يعلق على واحد ، ومتطلبات الاستعداد ، وسلوك الكاميرا والعلامة ، والدعم متعدد الخرائط ، والقيود المتنقلة أو WebGL.اسأل عما إذا كانت المنصة تعيد كائنات المكان ، والمعرفات المستقرة ، والإحداثيات ، والهندسة ، ومراجع المصدر ، وكائنات العمل ، والحالات التي لا تنتج عنها ، والنتائج النهائية ، والأخطاء الصريحة ؛ تجنب بنية الإنتاج التي تستخرج الحقائق الجغرافية من نثر النموذج.تحقق من الفصل القابل للنشر وسحب بيانات الاعتماد ، وقيود المنشأ ، وجلسات المتصفح قصيرة الأجل ، والنطاقات ، والإلغاء ، و CORS ، وعزل المستأجر ، وحدود البيانات الخاصة ، ودعم التدقيق.اختبار تحميل البرنامج النصي، إطار التمزق، وتغييرات المسار، وحدود العرض من جانب الخادم، والخرائط المتزامنة، واسترداد الأخطاء، والتحميل الكسول.تحديد ما إذا كان SDK عبارة عن غلاف واجهة المستخدم فقط أو ما إذا كانت المنصة تعرض أيضًا واجهات برمجة التطبيقات الموثقة لسير العمل المخصص.مراجعة سياسة الإصدار الرئيسية ، سجل التغيير ، نوافذ الاستهلاك ، تثبيت CDN ، قابلية نقل المزود ، ومسارات تصدير البيانات.قم بقياس الوقت إلى النتيجة المفيدة الأولى ، ومدة البث ، ومعدلات الخطأ وعدم النتائج ، ونجاح عمل الخريطة ، واستخدام المزود والذكاء الاصطناعي ، واستخدام الحصص ، والتكلفة لكل مهمة مستخدم مكتملة - وليس تحميل SDK وحده.
وتشمل حالات الاستخدام الشائعة اكتشاف مكان المحادثة؛ السفر ومنتجات الوجهة (خريطة السياحة التي تعمل بالذكاء الاصطناعي; البحث عن الممتلكات والسوق؛ مواقع المتاجر؛ إنشاء خريطة مدمجة داخل سير عمل SaaS؛ تجارب خريطة ذات علامة تجارية مع خرائط أساسية مصممة؛ والعمليات الداخلية على الأصول والأقاليم المصرح بها.في كل حالة، تفسر طبقة الذكاء الاصطناعي الطلب بينما تقوم الأنظمة المضيفة بالتحقق من صحة الحقائق وفرض الأذونات.
| خطأ | ماذا يحدث | التصحيح الموصى به |
|---|---|---|
| التركيب قبل وجود الخريطة الحية | لا يمكن أن يلحق SDK بالمعرض المقصود | تهيئة الخريطة أولاً وتمرر الكائن المباشر |
| التعامل مع SDK كمصدر للحقيقة | يمكن أن تلغي الحقائق المولدة السجلات الموثوقة | حافظ على المكان وأنظمة الأعمال موثوقة |
| إحداثيات تحليل من النثر | يصبح التكامل هشا | استخدام المكان المنظم وأحداث العمل |
| كشف مفتاح خادم في المتصفح | حامل الواجهة الخلفية يصبح علنيا | استخدام مفتاح قابل للنشر مقيد بالأصل |
| نسيان الأصول المسموح بها | تفشل طلبات المتصفح مع خطأ CORS أو الأصل | إضافة أصول المداسة والإنتاج الدقيقة |
| خلط الخريطة ومقدم الأوراق الماشية وأوراق اعتماد الذكاء الاصطناعي | الأمن والفواتير والتصحيح تصبح غير واضحة | إدارة كل مزود بشكل مستقل |
| السماح بإجراءات عشوائية | يمكن أن يؤدي النموذج إلى سلوك غير مدعوم | استخدم قائمة مسموحة بإجراء موثق |
| تجاهل التمزق | SPAs تسرب المستمعين أو الجداول أو المكونات المكررة | ابق على المقبض والمكالمة destroy() |
| تتبع الأحمال SDK فقط | التنشيط الفني يخطئ في قيمة المستخدم | قياس المهام التي تم حلها والنتائج النهائية |
| تخطي اختبار الهاتف المحمول وسهولة الوصول | الدردشة يمكن أن تحجب الخريطة أو التركيز على الفخ | اختبار التخطيط المتجاوب ، أمر لوحة المفاتيح ، والتسميات |
الخلاصة
خريطة الذكاء الاصطناعي SDK هي طبقة التطبيق التي تحول إخراج الذكاء الاصطناعي إلى تجربة منتج مكاني محكومة.تربط الطبقة نية اللغة الطبيعية بالأماكن المنظمة ، وإجراءات الخريطة المدعومة ، والواجهات القابلة لإعادة الاستخدام ، والمصادقة الآمنة للمتصفح ، والمعرض المباشر.استخدم SDK لخريطة الذكاء الاصطناعي عندما يحتاج المنتج إلى تفاعل خريطة محادثة أو مكونات مكانية مضمنة أو مسار أسرع من الاستدلال إلى السلوك الجغرافي المرئي.استخدم واجهات برمجة التطبيقات المباشرة عندما يحتاج الفريق المضيف إلى واجهة مخصصة أو أوركسترات من جانب الخادم ، واستخدم كليهما عندما يستفيد المتصفح من مكون محتفظ به بينما يجب أن تتحكم الواجهة الخلفية في استرجاع الخاص والسياسة والتفويض.قم بتقييم ما إذا كان SDK يحافظ على سلطة البيانات ، وينتج نتائج جغرافية منظمة ، ويدعم المُعرض قيد الاستخدام بالفعل ، ويفرض حدودًا آمنة للوقاء ، ويتعامل مع دورة الحياة والأخطاء ، ويحسن مهمة المستخدم القابلة للقياس - ليس فقط مدى سرعة تحميل العرض التجريبي.
أضف طبقة ذكاء اصطناعي إلى خريطتك الحالية
اربط دردشة Kaleidr بتطبيق مدعوم من Mapbox أو Google Maps أو MapLibre باستخدام أداة تحميل واحدة ومفتاح قابل للنشر ونسخة الخريطة الحية. اقرأ دليل البدء السريع لحزمة Kaleidr لتركيب الدردشة. استخدم نقاط نهاية واجهة المنصة عندما تحتاج الواجهة الخلفية إلى الاستدلال أو الاسترجاع أو التوجيه أو التصميم من جانب الخادم باستخدام مفتاح خادم.
الأسئلة الشائعة
ما حزمة تطوير خرائط الذكاء الاصطناعي؟
خريطة الذكاء الاصطناعي SDK هي مجموعة أدوات تطوير البرامج التي تربط استدلال الذكاء الاصطناعي بخريطة حية أو مكون مكاني مضمن.يمكنه إدارة واجهة المستخدم والمصادقة وأحداث المكان المنظمة وإجراءات الخريطة ومحولات المزود ودورة الحياة والوصول إلى واجهة برمجة التطبيقات.
هل هي نفسها واجهة برمجة الخرائط؟
لا.توفر واجهة برمجة تطبيقات الخرائط عادة البيانات أو العمليات الجغرافية عن بعد.توفر خريطة الذكاء الاصطناعي SDK طبقة تكامل التطبيقات التي تربط بين AI و واجهة المستخدم وحالة الخريطة والمصادقة والإجراءات المنظمة.
هل تحل محل Mapbox أو Google Maps أو MapLibre؟
ليس بالضرورة.تعلق دردشة Kaleidr الحالية SDK على خريطة حية مدعومة بينما يواصل المزود الحالي عرض الخريطة.
هل ينبغي للمتصفح استخدام مفتاح خادم؟
لا.استخدم مفتاحًا آمنًا للنشر في المتصفح من خلال SDK.احتفظ بمفاتيح الخادم على الواجهة الخلفية.
هل يمكنها استخدام بيانات أعمال خاصة؟
نعم، من خلال بنية معتمدة.يجب أن تسترجع الواجهة الخلفية للمضيف السجلات المسموح بها فقط ، وتفرض وصول المستأجر والكائن ، وتقلل من الحقول المكشوفة ، وتحافظ على نظام الأعمال موثوقًا.
المراجع
- Google. Maps JavaScript API Overview. Google Maps Platform documentation. Accessed 1 August 2026. https://developers.google.com/maps/documentation/javascript/overview
- Google. Maps JavaScript API: Maps Reference. Google Maps Platform documentation. Accessed 1 August 2026. https://developers.google.com/maps/documentation/javascript/reference/map
- Kaleidr. Auth & scopes. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/platform-api/auth-and-scopes
- Kaleidr. CDN versioning. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/reference/cdn-versioning
- Kaleidr. Chat — attach AI to your map. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/sdk/chat-attach
- Kaleidr. CORS & allowed origins. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/platform-api/cors-and-allowed-origins
- Kaleidr. Endpoints. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/platform-api/endpoints
- Kaleidr. Introduction. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/
- Kaleidr. kaleidr.js — the loader. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/sdk/kaleidr-js
- Kaleidr. kaleidr-map — the element. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/sdk/kaleidr-map-element
- Kaleidr. Quota & rate limits. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/platform-api/quota-and-rate-limits
- Kaleidr. Quickstart. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/quickstart
- Kaleidr. SSE wire contract. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/platform-api/sse-wire-contract
- Kaleidr. Viewer — embed a published map. Kaleidr Developer Docs. Accessed 1 August 2026. https://docs.kaleidr.com/sdk/viewer-embed
- Mapbox. Map — Mapbox GL JS. Accessed 1 August 2026. https://docs.mapbox.com/mapbox-gl-js/api/map/
- MapLibre. Map — MapLibre GL JS. Accessed 1 August 2026. https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/
- MDN Web Docs. Using Custom Elements. Accessed 1 August 2026. https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements
- MDN Web Docs. Using Server-Sent Events. Accessed 1 August 2026. https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events
@misc{kaleidr_sdk_loader,
title = {kaleidr.js -- the loader},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 1 August 2026},
url = {https://docs.kaleidr.com/sdk/kaleidr-js}
}
@misc{kaleidr_chat_attach,
title = {Chat -- attach AI to your map},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 1 August 2026},
url = {https://docs.kaleidr.com/sdk/chat-attach}
}
@misc{kaleidr_auth_scopes,
title = {Auth \& scopes},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 1 August 2026},
url = {https://docs.kaleidr.com/platform-api/auth-and-scopes}
}
@misc{kaleidr_sse_contract,
title = {SSE wire contract},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 1 August 2026},
url = {https://docs.kaleidr.com/platform-api/sse-wire-contract}
}
@misc{mdn_custom_elements,
title = {Using Custom Elements},
author = {{MDN Web Docs}},
note = {Accessed 1 August 2026},
url = {https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements}
}
@misc{mdn_server_sent_events,
title = {Using Server-Sent Events},
author = {{MDN Web Docs}},
note = {Accessed 1 August 2026},
url = {https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events}
}
@misc{mapbox_map_object,
title = {Map -- Mapbox GL JS},
author = {{Mapbox}},
note = {Accessed 1 August 2026},
url = {https://docs.mapbox.com/mapbox-gl-js/api/map/}
}
@misc{maplibre_map_object,
title = {Map -- MapLibre GL JS},
author = {{MapLibre}},
note = {Accessed 1 August 2026},
url = {https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/}
}