مجموعة تطوير خرائط (SDK) مقابل واجهة برمجة تطبيقات الخرائط (API) مقابل منصة الخرائط

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

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

** أساسيات المقارنة **

• ** سمِّ المهمة، ثم الطبقة: ** يتحكم SDK في سلوك العميل؛ وتتحكم واجهة برمجة التطبيقات في عقد الخدمة؛ وتتحكم المنصة في العمليات المشتركة.
• ** لا تتعامل مع المصطلحات على أنها متنافسة: ** تستخدم منتجات الإنتاج بشكل روتيني SDK وواجهة برمجة التطبيقات وعناصر تحكم المنصة معًا.
• ** الحفاظ على صلاحية قواعد المضيف: ** تبقى الهوية، وصلاحيات المستأجر، والسجلات الخاصة، والمعاملات ضمن تطبيق المضيف.
• ** تقسيم بيانات الاعتماد حسب وقت التشغيل: ** تُعد المفاتيح القابلة للنشر الآمنة للمتصفح ومفاتيح الخادم نماذج تهديد مختلفة.
• ** تأكيد العقد الحالي: ** تصف وثائق مطوري Kaleidr حاليًا منتجات kaleidr.js، وعائلات واجهات برمجة تطبيقات المنصة، ونطاقات المفاتيح؛ ولا يُعد المحتوى التسويقي عقد واجهة برمجة التطبيقات.

ما الفرق بين حزمة تطوير الخرائط (SDK) وواجهة برمجة تطبيقات الخرائط ومنصة الخرائط؟

يكمن التقسيم المفيد في الوظيفة التي تؤديها كل طبقة. يوجد SDK الخاص بالخرائط في العميل ويُغلف سلوكيات قابلة لإعادة الاستخدام: المكونات، ودورة حياة الربط، وربط الخرائط، والأحداث، وإدارة الجلسات الآمنة للمتصفح. أما واجهة برمجة تطبيقات الخرائط (API) فهي عبارة عن عقد برمجي لقدرة مكانية مثل البحث، والتوجيه، والاسترجاع، والاستدلال، والبلاطات، أو التصميم. منصة الخرائط هي النظام الأوسع الذي يمكن أن يشمل كليهما، بالإضافة إلى المصادقة، وخدمات البيانات، والأدوات، والتحليلات، والنشر، والحصص، والدعم. تُعرّف AWS حاليًا SDK على أنه مجموعة من أدوات البناء الخاصة بالمنصة مثل المكتبات، بينما واجهة برمجة التطبيقات (API) هي آلية تُمكّن مكونين برمجيين من التواصل باستخدام بروتوكولات مُحددة مسبقًا، وتُشير إلى أن SDK قد يتضمن واجهات برمجة تطبيقات (API) من بين موارد أخرى (ما الفرق بين SDK وAPI؟).

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

ما هو SDK للخرائط؟

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

تجعل منصات الويب هذه الحزمة ملموسة. يصف MDN حاليًا العناصر المخصصة بأنها عناصر HTML يُحددها المطور، مما يوسع مجموعة العناصر المتاحة في المتصفح (استخدام العناصر المخصصة). تستخدم حزمة تطوير البرامج (SDK) الخاصة بالخرائط، والتي تُثبّت عنصرًا مخصصًا، عقد المتصفح التالي: تُعلن الصفحة المضيفة عن المكون أو تُحمّله، وتتولى حزمة تطوير البرامج إدارة الإصدارات، وتحميل الحزم، ودورة حياة المكون. تُوثّق Kaleidr حاليًا kaleidr.js على أنها مُحمّل بسيط يُثبّت window.Kaleidr وعنصر <kaleidr-map>، ويُحمّل حزم المنتجات عند الحاجة، ويتولى إدارة الإصدارات، والتكوين، وتمرير المفاتيح، ودورة حياة التحميل، وتطبيع الأخطاء (kaleidr.js — المُحمّل).

لا تُستبدل حزمة تطوير البرامج (SDK) التطبيق المضيف. لا يزال التطبيق المضيف مسؤولاً عن الهوية، وصلاحيات المستأجر، والبيانات الخاصة، وسير العمل. وينطبق الأمر نفسه على تطبيقات الذكاء الاصطناعي: تربط حزمة تطوير البرامج (SDK) النوايا، والأماكن المنظمة، وإجراءات الخريطة بمُعرِض مباشر دون أن تُصبح المصدر الموثوق للمخزون أو الأهلية.

ما هي واجهة برمجة تطبيقات الخرائط (Map API)؟

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

نموذج الطلب هو بنية ويب عادية. يصف MDN حاليًا واجهة Fetch API بأنها واجهة لجلب الموارد عبر الشبكة باستخدام كائنات Request وResponse (Fetch API). استدعاء واجهة برمجة تطبيقات الخرائط هو نفس النمط المطبق على العمل المكاني: يرسل التطبيق طلبًا منظمًا، ويتلقى استجابة أو دفقًا منظمًا، ثم يقرر ما سيتم عرضه. يضع Kaleidr حاليًا مسارات Platform API ضمن https://api.kaleidr.com/inference-api/b2b/v1/ ويوثق الدردشة والتوجيه وإثراء نقاط الاهتمام وتبادل جلسات SDK وعائلات التصميم في مرجع نقطة النهاية العامة (Endpoints). يمكن أن تتطور قائمة المسارات الدقيقة، لذلك يجب على التطبيقات استخدام مرجع المطور الحالي بدلاً من أمثلة المدونة كمصدر موثوق.

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

ما هي منصة الخرائط؟

تجمع منصة الخرائط عدة مكونات أساسية حول نموذج مشترك للحساب والبيانات والأمان والتشغيل. يمكن أن تظهر حزم تطوير البرامج (SDKs) وواجهات برمجة التطبيقات (APIs) ضمن هذا النموذج، ولكن السمة المميزة هي الشمولية بالإضافة إلى البنية التحتية المشتركة: العرض، والبحث، والتوجيه، وبيانات الأماكن، والبلاطات، وتصميم الخرائط، والمصادقة، وضوابط الاستخدام، والتحليلات، والنشر، والدعم. تُعرّف الأسئلة الشائعة من جوجل حاليًا منصة خرائط جوجل على أنها واجهات برمجة تطبيقات وحزم تطوير برامج تُستخدم معًا بدلاً من كونها نقطة نهاية واحدة. يقسم Mapbox حاليًا الفكرة نفسها إلى خرائط، وبحث، وملاحة، ومنتجات بيانات، وأدوات مثل Mapbox Studio.

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

يصف Kaleidr حاليًا مقدمة المطورين بأنها نظام رئيسي واحد على مستوى المؤسسة، يتمتع بنطاقات قدرات للذكاء الاصطناعي والخرائط والتصميم، في شكلين قابل للنشر والخادم (البناء باستخدام Kaleidr). ويُعرّف Kaleidr Enterprise حاليًا هذه الحزمة التجارية على أنها ذكاء مكاني مُصمم لحزمة منتجات موجودة، مع حزم تطوير برمجية (SDKs) وواجهات برمجة تطبيقات للاستدلال والتصنيف والتحليلات ودعم النشر (واجهات برمجة تطبيقات ذكاء الموقع وحزمة تطوير برمجية للخرائط). يُرجى التأكد من باقات الاشتراك الحالية على الأسعار والخطط قبل الاعتماد على سير عمل إنتاجي مُحدد.

ما الطبقة المسؤولة عن كل مسؤولية؟

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

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

متى يجب على الفريق اختيار SDK أو API أو منصة؟

ابدأ بأبسط تكامل يلبي متطلبات المنتج، ثم انتقل إلى تكامل أعمق فقط عندما يتطلب الأمر تحكمًا أو تنسيقًا. تكفي خريطة منشورة أو تضمين عارض لعرض خريطة مصممة. يكفي مكون SDK لإضافة دردشة أو محرر أو مربعات إلى واجهة المضيف. تُعد واجهة برمجة تطبيقات النظام الأساسي الخطوة التالية المناسبة عندما يجب أن تتولى طبقة التطبيق مسؤولية إنشاء الطلبات أو ربط البيانات الخاصة أو واجهة مستخدم مخصصة. يُعد تكامل المؤسسة خيارًا للحوكمة والعمليات، وليس شرطًا لاستبدال العارض الحالي.

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

كيف يرتبط Kaleidr بهذه الطبقات؟

يوفر Kaleidr حاليًا طبقة JavaScript SDK وطبقة Platform API، بينما توفر Enterprise واجهة تجارية وتشغيلية أوسع. يستخدم دليل البدء السريع للمطورين حاليًا مُحمِّلًا واحدًا مُرقَّمًا في https://cdn.kaleidr.com/embed/v1/kaleidr.js. يمكن لهذا المُحمِّل تحميل حزم المنتجات لـ chat وviewer وeditor وtile. يتصل Chat حاليًا بمثيل Mapbox أو MapLibre أو Google Maps أو Leaflet مباشر بدلاً من استبدال المُعرِض (Quickstart). كيفية إضافة دردشة الذكاء الاصطناعي إلى Mapbox وخرائط جوجل وMapLibre هو المسار العملي للربط. كيفية تضمين خريطة تفاعلية يغطي تضمين الخرائط المنشورة.

حزم المنتجات ليست أسماءً قابلة للتبديل لمكون واحد. يُستخدم العارض لعرض خريطة منشورة. تُستخدم الدردشة للتفاعل الحواري على خريطة مضيفة مباشرة. يُستخدم المحرر لتضمين إمكانية تأليف الخرائط؛ Map Editor SDK يغطي حالة SaaS هذه. تُستخدم البلاطة لاستخدام نمط خريطة أساسية مصمم. اختر حسب مهمة المنتج. تتغير التفاصيل الفنية أيضًا بشكل أسرع من صفحات تحديد المواقع. تشير وثائق البدء السريع للمطورين ومرجع kaleidr.js الحاليين إلى أن برنامج Viewer المنشور يستخدم معرّف مشاركة ولا يحتاج إلى مفتاح. للتنفيذ، يُرجى اعتبار وثائق المطورين المصدر الموثوق.

كيف يختلف التوثيق بين SDK وAPI؟

يختلف نموذج التهديد بين تكامل المتصفح وتكامل طبقة التطبيق. يمكن عادةً فحص أي بيانات تُرسل إلى المتصفح، لذا لا ينبغي تضمين سر الخادم طويل الأمد في مصدر الصفحة أو حزم العميل أو المستودعات العامة. يستخدم Kaleidr حاليًا مفتاحًا قابلاً للنشر لاستخدام SDK الخاص بالمتصفح؛ حيث يستبدله SDK بجلسة قصيرة الأمد مرتبطة بالمصدر. يُستخدم مفتاح الخادم للاستخدام الموثوق به على طبقة التطبيق، ويمكن إرساله كحامل أو X-Api-Key. ينص مرجع المصادقة الحالي على أنه يتم رفض المفتاح القابل للنشر المقدم مباشرة كحامل، وأن مفتاح الخادم لا يحصل على منح CORS، وأن SDK يرفض مفاتيح الخادم عند التحميل حتى تبقى على جانب الخادم (Auth & scopes).

يمكن لحزمة تطوير البرامج (SDK) إخفاء مسار المتصفح الشائع. تشير وثائق مرجع نقطة النهاية الحالية إلى أن POST /sdk/sessions هي منصة التبادل التي تقبل مفتاحًا قابلاً للنشر، وتنص على أن حزمة تطوير البرامج تستدعي هذه المنصة عند التحميل في عمليات التكامل العادية للمتصفح (Endpoints). بدون حزمة تطوير البرامج، سيحتاج التطبيق إلى التعامل مع التحقق من المصدر، واختيار المنتج، وفحوصات النطاق، وتبادل الجلسات قصيرة الأجل، ودورة حياة حزمة المنتج. لا يزال استخدام واجهة برمجة التطبيقات (API) المباشرة مناسبًا عندما يتعين على المضيف التحكم في إنشاء الطلب، والبث، وإعادة المحاولات، وتفويض البيانات الخاصة. يميز Kaleidr حاليًا بين بيانات الاعتماد المفقودة أو غير الصالحة وبيانات الاعتماد الصالحة ذات النطاق غير الكافي، ويوثق شرطًا منفصلاً للحد من المعدل. يجب أن تحافظ سجلات التطبيق على هذا التمييز بدلاً من دمج كل فشل في عبارة "فشل الربط".

ما الأخطاء التي يجب على الفرق تجنبها؟

يتمثل الفشل المتكرر في التعامل مع المصطلحات القريبة كبدائل. إن شراء حزمة تطوير البرامج مقابل واجهة برمجة التطبيقات ليس خيارًا بين أمرين. غالبًا ما تستدعي حزمة تطوير البرامج (SDK) واجهات برمجة التطبيقات (APIs) الخاصة بالمنصة في الخلفية؛ وتُعدّ حزمة تطوير البرامج واجهة تطوير عالية المستوى، وليست دليلًا على عدم وجود عقد خدمة. لا تتطلب واجهة برمجة التطبيقات بناء كل واجهة من الصفر؛ فالعديد من المنتجات تستخدم حزمة تطوير البرامج لواجهة المستخدم وواجهة برمجة التطبيقات لتنسيق طبقة التطبيق. لا تتطلب المنصة استبدال مجموعة الخرائط الحالية. توثّق Kaleidr حاليًا إمكانية ربط الدردشة بخريطة مدعومة موجودة، وتُصمّم Enterprise حاليًا عرضها التجاري حول مجموعة منتجات موجودة. ... خطأ

كيف تبدأ الفرق بالتكامل؟

اختر الطبقة المناسبة للمهمة، ثم أضف العمق فقط عند الحاجة. استخدم حزمة تطوير البرامج (SDK) لسلوك العميل القابل لإعادة الاستخدام، وواجهة برمجة التطبيقات (API) للتحكم على مستوى الخدمة، والمنصة للبنية التحتية المكانية المشتركة. يتبع Kaleidr حاليًا هذا النموذج بدقة: kaleidr.js توفر طبقة تكامل خفيفة الوزن للمتصفح، وواجهة برمجة تطبيقات المنصة تعرض خدمات الاستدلال والتصميم الموثقة، وKaleidr Enterprise توفر حزمة البرامج التجارية الأوسع للفرق التي تُنشئ منتجات مكانية. اقرأ وثائق مطوري Kaleidr للاطلاع على أداة التحميل الحالية، والمصادقة، وعقد نقطة النهاية. استكشف Kaleidr Enterprise للاطلاع على حزم تطوير البرامج (SDKs)، وواجهات برمجة تطبيقات الاستدلال، ومعلومات الموقع، ودعم النشر الموضحة في الصفحة العامة الحالية.

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

ما الفرق بين حزمة تطوير البرامج (SDK) للخرائط وواجهة برمجة تطبيقات الخرائط (API)؟ ...

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

هل حزمة تطوير البرمجيات للخرائط مجرد غلاف لواجهة برمجة التطبيقات؟

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

ما هي منصة الخرائط؟

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

هل ينبغي للفريق استخدام حزمة تطوير البرمجيات أم واجهة برمجة التطبيقات؟

استخدم حزمة تطوير البرامج (SDK) عندما يتوافق مكون العميل المدعوم مع المنتج. استخدم واجهة برمجة التطبيقات (API) عندما يحتاج المضيف إلى تحكم مباشر على مستوى الخدمة أو تنسيق على مستوى التطبيق. تستخدم العديد من المنتجات كليهما.

هل تحل حزمة تطوير البرامج (SDK) محل مُعرِّض الخريطة؟

ليس بالضرورة. توثق Kaleidr Chat حاليًا إمكانية الربط بخريطة موجودة من Mapbox أو MapLibre أو خرائط Google أو Leaflet. تعتمد منتجات SDK الأخرى، مثل Viewer أو Editor، نماذج ملكية مختلفة للمُعرِّض.

متى يجب أن يتم استدعاء واجهة برمجة التطبيقات (API) في طبقة التطبيق؟

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

ما الفرق بين المنصة ومنشئ الخرائط بدون كتابة أكواد؟

يركز منشئ الخرائط بدون كتابة أكواد على التأليف والنشر. أما المنصة، فيمكن أن تشمل أدوات الإنشاء، بالإضافة إلى حزم تطوير البرامج (SDKs)، وواجهات برمجة التطبيقات (APIs)، والمصادقة، وخدمات البيانات، والتحليلات، وأدوات التحكم المؤسسية.

كيف يعرض Kaleidr حاليًا حزمة تطوير البرامج (SDK) وواجهات برمجة التطبيقات (APIs) الخاصة به؟

يستخدم Kaleidr حاليًا مُحمِّل kaleidr.js مُرقَّمًا يقوم بتثبيت window.Kaleidr و<kaleidr-map>، مع حزم منتجات للدردشة، والعارض، والمحرر، والبلاطات. توثق واجهة برمجة تطبيقات المنصة العامة الحالية الدردشة، والتوجيه، وإثراء نقاط الاهتمام، وتبادل جلسات حزمة تطوير البرامج (SDK)، وعائلات التصميم ضمن عنوان URL الأساسي لواجهة برمجة تطبيقات الاستدلال B2B.

هل يتطلب عارض Kaleidr مفتاحًا قابلًا للنشر؟

تشير وثيقة البدء السريع للمطورين ومرجع kaleidr.js الحاليين إلى أن العارض المنشور يستخدم مُعرِّف مشاركة ولا يحتاج إلى مفتاح.

هل يمكن لـ Kaleidr العمل مع حزمة خرائط موجودة؟

توثق Kaleidr حاليًا إمكانية ربط Chat بخرائط المضيف الحية المدعومة، وتعرض Kaleidr Enterprise حاليًا الحل باعتباره ذكاءً مكانيًا مصممًا لحزمة تقنية موجودة. ولا يُعد استبدال موفر الخرائط الحالي جوهر هذا التموضع.

المراجع

• خدمات أمازون السحابية. ما الفرق بين SDK وAPI؟. تاريخ الوصول: 3 سبتمبر 2026. https://aws.amazon.com/compare/the-difference-between-sdk-and-api/
• Google Maps Platform. الأسئلة الشائعة حول منصة خرائط جوجل. تم الاطلاع عليها في 3 سبتمبر 2026. https://developers.google.com/maps/faq
• Google Maps Platform. واجهات برمجة تطبيقات منصة خرائط جوجل حسب المنصة. تم الوصول إليها في 3 سبتمبر 2026. https://developers.google.com/maps/apis-by-platform
• Mapbox. البدء. تم الوصول إليها في 3 سبتمبر 2026. https://docs.mapbox.com/help/getting-started/
• MDN. باستخدام عناصر مخصصة. تم الاطلاع عليه في 3 سبتمبر 2026. https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements
• MDN. واجهة برمجة تطبيقات الجلب. تم الاطلاع عليه في 3 سبتمبر 2026. https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
• Kaleidr. البناء باستخدام Kaleidr. وثائق المطورين. تم الاطلاع عليه في 3 سبتمبر 2026. https://docs.kaleidr.com/
• Kaleidr. البدء السريع. وثائق المطورين. تم الاطلاع عليه في 3 سبتمبر 2026. https://docs.kaleidr.com/quickstart
• Kaleidr. kaleidr.js — أداة التحميل. وثائق المطورين. تم الاطلاع عليه في 3 سبتمبر 2026. https://docs.kaleidr.com/sdk/kaleidr-js
• Kaleidr. المصادقة والنطاقات. وثائق المطورين. تم الاطلاع عليه في 3 سبتمبر 2026. https://docs.kaleidr.com/platform-api/auth-and-scopes
• Kaleidr. نقاط النهاية. وثائق المطورين. تم الاطلاع عليه في 3 سبتمبر 2026. https://docs.kaleidr.com/platform-api/endpoints
• Kaleidr. واجهات برمجة تطبيقات ذكاء الموقع وحزمة تطوير الخرائط. تم الاطلاع بتاريخ 3 سبتمبر 2026. https://kaleidr.com/enterprise

@misc{aws_sdk_api_difference_2026_09_03,
  title  = {What's the Difference Between SDK and API?},
  author = {{Amazon Web Services}},
  note   = {Accessed 3 September 2026},
  url    = {https://aws.amazon.com/compare/the-difference-between-sdk-and-api/}
}

@misc{google_maps_platform_faq_2026_09_03,
  title  = {Google Maps Platform FAQ},
  author = {{Google Maps Platform}},
  note   = {Accessed 3 September 2026},
  url    = {https://developers.google.com/maps/faq}
}

@misc{google_maps_apis_by_platform_2026_09_03,
  title  = {Google Maps Platform APIs by Platform},
  author = {{Google Maps Platform}},
  note   = {Accessed 3 September 2026},
  url    = {https://developers.google.com/maps/apis-by-platform}
}

@misc{mapbox_getting_started_2026_09_03,
  title  = {Getting Started},
  author = {{Mapbox}},
  note   = {Accessed 3 September 2026},
  url    = {https://docs.mapbox.com/help/getting-started/}
}

@misc{mdn_using_custom_elements_2026_09_03,
  title  = {Using custom elements},
  author = {{MDN}},
  note   = {Accessed 3 September 2026},
  url    = {https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements}
}

@misc{mdn_fetch_api_2026_09_03,
  title  = {Fetch API},
  author = {{MDN}},
  note   = {Accessed 3 September 2026},
  url    = {https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API}
}

@misc{kaleidr_docs_intro_2026_09_03,
  title  = {Build with Kaleidr},
  author = {{Kaleidr}},
  note   = {Developer documentation; accessed 3 September 2026},
  url    = {https://docs.kaleidr.com/}
}

@misc{kaleidr_quickstart_2026_09_03,
  title  = {Quickstart},
  author = {{Kaleidr}},
  note   = {Developer documentation; accessed 3 September 2026},
  url    = {https://docs.kaleidr.com/quickstart}
}

@misc{kaleidr_js_loader_2026_09_03,
  title  = {kaleidr.js -- the Loader},
  author = {{Kaleidr}},
  note   = {Developer documentation; accessed 3 September 2026},
  url    = {https://docs.kaleidr.com/sdk/kaleidr-js}
}

@misc{kaleidr_auth_scopes_2026_09_03,
  title  = {Auth \& scopes},
  author = {{Kaleidr}},
  note   = {Developer documentation; accessed 3 September 2026},
  url    = {https://docs.kaleidr.com/platform-api/auth-and-scopes}
}

@misc{kaleidr_endpoints_2026_09_03,
  title  = {Endpoints},
  author = {{Kaleidr}},
  note   = {Developer documentation; accessed 3 September 2026},
  url    = {https://docs.kaleidr.com/platform-api/endpoints}
}

@misc{kaleidr_enterprise_2026_09_03,
  title  = {Location Intelligence APIs and Map SDK},
  author = {{Kaleidr}},
  note   = {Accessed 3 September 2026},
  url    = {https://kaleidr.com/enterprise}
}