كيفية إضافة دردشة بالذكاء الاصطناعي إلى خريطة

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

لا يعني إضافة المساعد نقل جميع مسؤوليات المنتج إلى النموذج. فما يزال تكامل الإنتاج يحتاج إلى مفتاح متصفح مقيّد بحسب الأصل، وبيانات مصدر موثوقة، ومعالجة لدورة الحياة خاصة بكل مزوّد، وحالات أخطاء واضحة، وإتاحة وصول، وتحليلات. تتناول الأقسام التالية هذه المتطلبات بالتتابع: تركيب SDK، وإعداد كل مزوّد، وأمن المفاتيح، وإسناد الإجابات إلى المصادر، وتجربة المستخدم، والاختبار، والمقاييس التي تبيّن ما إذا كان المساعد يساعد في إنجاز مهمة حقيقية. تعامل مع المقالة بوصفها مرجعاً معمارياً وتكاملياً، لا مجرد عرض للميزات. لتجربة الخريطة الحوارية قبل توصيل SDK، ابدأ من Kaleidr AI؛ ولمعرفة الفرق عن الخرائط المخصصة التي تُبنى يدوياً، راجع Kaleidr مقابل Google My Maps.

ما الذي ستبنيه

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

اعرض الأماكن العائلية بالقرب من الواجهة البحرية المفتوحة بعد ظهر اليوم.

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

كيف تعمل البنية المعمارية

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

يجب ألا يصبح نموذج اللغة هو المصدر الموثوق لل عناوين أو ساعات العمل أو المخزون أو الأهلية أو الطرق أو حالة الملكية أو حقائق الأعمال الداخلية.تفسر طبقة الذكاء الاصطناعي الطلب وتنسق الإجراءات المدعومة، بينما تقوم الخدمات الموثوقة بالتحقق من صحة الحقائق التي تعتمد عليها الإجابة.يعكس عقد البث الذي يتبّعه Kaleidr أن الانفصال: يصل النثر بشكل تدريجي ، وتصل الأماكن التي تم حلها كأحداث place منظمة ، ويمكن أن تصل عمليات الخرائط في early_actions ، ويمكن أن تصل معلومات المصدر في grounding ، ويحمل الحدث النهائي end النص الكامل والأماكن والإجراءات.لا يحلل المطورون الذين يستخدمون kaleidr.js هذه الأحداث باليد ، ويمكن للفرق التي تبني عميلًا مخصصًا اتباع مرجع SSE wire-contract.

ما الذي تحتاج إليه قبل البدء؟

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

• صندوق خرائط يعمل أو Google Maps أو مثيل خريطة MapLibre ؛
• منظمة Kaleidr مع الوصول إلى واجهة برمجة تطبيقات الدردشة ؛
• مفتاح متصفح Kaleidr القابل للنشر الذي يحمل نطاق ai ؛
• أصل متصفح واحد على الأقل مسموح به للمفتاح القابل للنشر المباشر ؛
• محمل kaleidr.js الحالي ؛
• حاوية خريطة ذات ارتفاع صريح ؛
• حاوية دردشة أو عنصر مخصص مدعوم ؛
• اعتماد المزود المطلوب بواسطة Mapbox أو Google Maps ؛
• أسئلة تمثيلية مستمدة من سير عمل المستخدم الحقيقي ؛
• تحديد أنظمة مصدر الحقيقة لأي حقائق تشغيلية.

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

كيفية إضافة دردشة بالذكاء الاصطناعي إلى خريطة باستخدام Kaleidr SDK

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

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>

يقوم اللودر بتثبيت window.Kaleidr وعنصر <kaleidr-map> ، ويسحب حزمة المنتج المحددة في الخلفية فقط عند الحاجة ؛ لا يقوم اللودر نفسه بحزم MapLibre ولا React.يدعم SDK منتجات chat و viewer و editor و editor والبلاط ، لذا اتبع قيمة المنتج الدقيقة المعروضة في الصفحة الحالية للتضمين المحدد الذي تقوم ببنائه.بالنسبة للخريطة الحية التي تمتلكها بالفعل ، فإن واجهة برمجة التطبيقات الحتمية هي أوضح مسار.المثال أدناه يسلم كائن الخريطة الموجود مباشرة إلى Kaleidr:

<div class="map-chat-layout">
  <div id="map" aria-label="Interactive location map"></div>
  <aside id="chat" aria-label="AI map assistant"></aside>
</div>

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<script>
  function mountKaleidrChat(map) {
    if (!map) {
      throw new Error("A live map instance is required.");
    }

    return Kaleidr.mount("#chat", {
      product: "chat",
      publishableKey: "kld_pk_live_REPLACE_ME",
      map,
    });
  }
</script>

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

إضافة دردشة بالذكاء الاصطناعي إلى Mapbox

يقوم Mapbox GL JS بإنشاء مثيل mapboxgl.Map داخل حاوية المتصفح ، ويتطلب رمز وصول.يوصي Mapbox برمز عام موسعًا لما يحتاجه تطبيق العميل فقط ، مع تطبيق قيود عنوان URL وعمليات النطاق السري المحفوظة على الخادم.يقترن المثال أدناه بالإرشادات مع مكالمة جبل Kaleidr الموثقة.قم بتحميل كل من البرامج النصية وإنشاء الخريطة وقم بتركيب الدردشة بمجرد أن تطلق الخريطة حدث load الخاص بها:

<link
  href="https://api.mapbox.com/mapbox-gl-js/v3.27.0/mapbox-gl.css"
  rel="stylesheet"
/>

<script src="https://api.mapbox.com/mapbox-gl-js/v3.27.0/mapbox-gl.js"></script>
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>

<div class="map-chat-layout">
  <div id="map" aria-label="Mapbox map"></div>
  <aside id="chat" aria-label="AI map assistant"></aside>
</div>

<script>
  const map = new mapboxgl.Map({
    accessToken: "YOUR_MAPBOX_PUBLIC_TOKEN",
    container: "map",
    center: [-0.12, 51.5],
    zoom: 11,
  });

  map.on("load", () => {
    try {
      window.kaleidrChat = Kaleidr.mount("#chat", {
        product: "chat",
        publishableKey: "kld_pk_live_REPLACE_ME",
        map,
      });
    } catch (error) {
      console.error("Kaleidr chat failed to mount:", error);
    }
  });

  map.on("error", (event) => {
    console.error("Mapbox error:", event.error ?? event);
  });
</script>

يُظهر دليل مزود Kaleidr حاليًا Mapbox GL JS v3.0.0 ، بينما يقوم دليل CDN الخاص بـ Mapbox بتوثيق إنشاء v3.27.0 لاحقًا ، لذا احتفظ بالإصدار الذي اختبره تطبيقك بالفعل وأكد التوافق قبل الترقية فقط لهذا التكامل.يقوم رمز Mapbox ومفتاح Kaleidr القابل للنشر بمصادقة الأنظمة والفاتورة المختلفة بشكل منفصل: يقوم الرمز المميز بمصادقة خدمات renderer و Mapbox ، ويصادق المفتاح القابل للنشر على نطاق دردشة AI من خلال متصفح SDK.إخفاقات الإعداد الأكثر شيوعًا هي ارتفاع حاوية الخريطة المفقودة ، ورمز Mapbox المرفوض أو المتخطي ، وتصاعد الدردشة قبل أن ينشئ التطبيق مثيل الخريطة.

إضافة دردشة بالذكاء الاصطناعي إلى Google Maps

تتطلب منصة Google Maps مفتاح API لـ Maps JavaScript ، وهي تدعم استيراد المكتبة الديناميكي وتحميل البرنامج النصي المباشر ومحمل NPM.يستخدم دليل التكامل الرسمي لKaleidr نمط الاسترداد المباشر ، وهو الخيار الأكثر قابلية للتنبؤ للتكامل الأول.يقوم إجراء الاتصال بإنشاء مثيل google.maps.Map ويمرره مباشرة إلى Kaleidr.mount.يقوم المثال أدناه بتوصيل المفتاح ، واسترداد المكالمات ، والجبل معًا:

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>

<div class="map-chat-layout">
  <div id="map" aria-label="Google map"></div>
  <aside id="chat" aria-label="AI map assistant"></aside>
</div>

<script>
  function initMap() {
    try {
      const map = new google.maps.Map(document.getElementById("map"), {
        center: { lat: 51.5, lng: -0.12 },
        zoom: 11,
      });

      window.kaleidrChat = Kaleidr.mount("#chat", {
        product: "chat",
        publishableKey: "kld_pk_live_REPLACE_ME",
        map,
      });
    } catch (error) {
      console.error("Google Maps or Kaleidr initialization failed:", error);
    }
  }

  window.gm_authFailure = function () {
    console.error("Google Maps authentication failed.");
  };
</script>

<script
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_GOOGLE_MAPS_KEY&callback=initMap"
  async
></script>

يخدم مفتاح Google Maps ومفتاح Kaleidr أنظمة وفوترة مختلفة بشكل مستقل ، لذا قيد مفتاح Google على مواقع الويب وواجهات برمجة التطبيقات المطلوبة ، وقيد مفتاح Kaleidr على الأصول المسموح بها بالضبط.تقوم Google Maps جافا سكريبت API بتحميل وفواتير خريطة Google ، في حين تقوم Kaleidr بتحميل المفتاح القابل للنشر وتفور قدرة الدردشة على الذكاء الاصطناعي.هناك تمييز آخر مهم: يستهدف هذا التكامل مثيل Google Maps JavaScript API داخل أحد التطبيقات ، ولا يعلق على مستند Google Maps My ، وهو منتج منفصل.

إضافة دردشة بالذكاء الاصطناعي إلى MapLibre

MapLibre GL JS هو مستعرض مفتوح المصدر لخرائط بلاط المتجهات ، ويجب أن يوفر تطبيق MapLibre نمطًا بالإضافة إلى مصادر البلاط والغليف والعفر التي تصمم المراجع.وبالتالي، يمتلك الفريق المضيف أكثر من قرار العرض والبنية التحتية مما يمتلكه من خلال خدمة خريطة مدارة بالكامل.تستخدم وثائق MapLibre الحالية وحدات ES في الإصدار 6.المثال أدناه يكيف هذا النمط مع مكالمة جبل Kaleidr:

<link
  href="https://unpkg.com/maplibre-gl@6.0.0/dist/maplibre-gl.css"
  rel="stylesheet"
/>

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>

<div class="map-chat-layout">
  <div id="map" aria-label="MapLibre map"></div>
  <aside id="chat" aria-label="AI map assistant"></aside>
</div>

<script type="module">
  import * as maplibregl from "https://unpkg.com/maplibre-gl@6.0.0/dist/maplibre-gl.mjs";

  const map = new maplibregl.Map({
    container: "map",
    style: "https://demotiles.maplibre.org/style.json",
    center: [-0.12, 51.5],
    zoom: 11,
  });

  map.on("load", () => {
    try {
      window.kaleidrChat = Kaleidr.mount("#chat", {
        product: "chat",
        publishableKey: "kld_pk_live_REPLACE_ME",
        map,
      });
    } catch (error) {
      console.error("Kaleidr chat failed to mount:", error);
    }
  });

  map.on("error", (event) => {
    console.error("MapLibre error:", event.error ?? event);
  });
</script>

يستخدم دليل MapLibre الحالي من Kaleidr بناء MapLibre على طراز UMD العالمي وعنوان URL للأسلوب الذي يستضيفه Kaleidr ، في حين انتقلت وثائق المزود إلى وحدات الإصدار 6 ES ، لذا اختر إصدار MapLibre واحدًا متسقًا وطريقة التحميل للتطبيق بدلاً من مزج الإصدارات العالمية والوحدة النمطية.لا توفر MapLibre خريطة أساسية عالمية مستضافة خاصة بها ، مما يعني أن مزود البلاط أو النمط التابع لجهة خارجية يجلب متطلبات الاعتماد والإسناد والترخيص والاستخدام والفوترة التي يجب عليك اتباعها.يمكن أيضًا إقران البلاط المصمم من قبل Kaleidr مع MapLibre حيث تدعم الخطة الحالية وتكوين النمط سير العمل.

ما الذي يجعل المساعد مدركاً للخريطة؟

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

1. يقوم المستخدم بإرسال سؤال الموقع.
2. يحدد Kaleidr المكان أو المنطقة أو القرب أو الفئة أو نية الطريق.
3. تقوم الخدمات ذات الصلة بحل الأماكن أو استرداد البيانات المعتمدة.
4. المكان المنظم وتدفق أحداث العمل إلى العميل.
5. يضيف التكامل دبابيس أو يؤطر منطقة أو يسلط الضوء على نتيجة أو يطبق عملية خريطة أخرى مدعومة.
6. تعرض الواجهة الإجابة النثرية مع الأدلة الجغرافية المرئية.

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

• place تحمل مكانًا تم حله وإحداثيات ؛
• place_linked تثري مكانًا موجودًا ؛
• يمكن لearly_actions أن تحمل إجراءات الخرائط المبكرة مثل وضع حدود مناسبة أو تسليط الضوء على النتيجة ؛
• وتحمل grounding مصادر للتناوب المرتكز؛
• end هو المغلف النهائي الموثوق الذي يحتوي على النص الكامل والأماكن والإجراءات ؛
• error تنهي البث برسالة خطأ.

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

المفاتيح القابلة للنشر مقابل مفاتيح الخادم

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

يتم رفض المفتاح القابل للنشر المباشر دون أصول مسموح بها تحت التدفق الموثق ، لذلك أضف أصول الإنتاج والتدريج الدقيقة عند سك المفتاح.يتم مطابقة رأس Origin لمتصفح كل طلب مع القائمة بالضبط ، لذلك يجب أن يكون الأصل المسموح به أصلًا عاريًا مثل https://app.example.com - المخطط والمضيف بدون مسار أو مائل زائدة - وتدرج كل أصل تخدم منه ، بما في ذلك أصل التطوير المحلي.تحمل المفاتيح أيضًا نطاقات القدرة: ai للدردشة والاستدلال ، و design لطرق التحرير ، و maps للخطوط الأساسية والبلاط المصممة.

تشير المنصة إلى مشاكل الاعتماد مع رموز الحالة المتميزة ، ويجب أن تعامل الواجهة كل واحدة بشكل مختلف.يعود 401 إلى بنك مفقود أو غير صالح أو مطلوب أو منتهية الصلاحية ؛ مفتاح صالح بدون النطاق المطلوب يعود 403 مع insufficient_scope ؛ وتعود 429 حدود الحصص أو التوافق ، والتي يجب أن تعاملها الواجهة كشرط للسعة أو الخطة بدلاً من فشل المنتج العام.تبقى بيانات اعتماد Mapbox وGoogle Maps منفصلة عن بيانات اعتماد Kaleidr طوال الوقت ، لذا ضع قيود كل مزود بشكل مستقل.

إسناد إجابات الذكاء الاصطناعي إلى بيانات مواقع موثوقة

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

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

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

نية المستخدم → تفسير الذكاء الاصطناعي → استرجاع موثوق أو دقة مكان → الإجراء المسموح به للخريطة → إجابة مرئية

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

هل يستطيع المساعد استخدام بيانات أعمال خاصة؟

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

• ما هي مجموعات البيانات التي قد يستعيض عنها المساعد ؛
• التي الصفات يمكن أن تترك نظام المصدر.
• التي يمكن للمستخدم والمستأجر الوصول إلى كل سجل؛
• كيف يتم فرض عزل المستأجر ؛
• ما هي الحقول الحساسة؛
• ما إذا كان الاسترجاع يمر عبر الواجهة الخلفية للمضيف ؛
• ما هو مسجل وإلى متى ؛
• كيف يتم الحفاظ على مصدر الإسناد؛
• ما هي المتطلبات الإقليمية أو التعاقدية أو الاحتفاظ بها التي تنطبق؛
• ما العمليات التي تتطلب تأكيدا بشريا.

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

أنماط تجربة المستخدم لدردشة خرائط مفيدة

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

إبقاء الخريطة ظاهرة

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

إظهار التغييرات التي يجريها المساعد

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

الحفاظ على عناصر التحكم اليدوية

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

دعم التراجع وإعادة الضبط

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

اقتراح أسئلة مفيدة

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

تصميم حالات انعدام النتائج والأخطاء

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

التصميم مع مراعاة إمكانية الوصول

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

الأحداث والمقاييس التي ينبغي تتبعها

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

map_chat_opened
map_chat_question_submitted
map_chat_answer_returned
map_chat_no_result
map_chat_error
map_action_applied
map_result_selected
map_marker_opened
map_chat_followup_submitted
map_chat_shared
map_chat_to_editor

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

• معدل إتمام السؤال؛
• الإجابة على نسبة النجاح؛
• معدل عدم وجود نتيجة؛
• معدل الخطأ التقني؛
• معدل نجاح عمل الخريطة؛
• معدل اختيار النتائج؛
• معدل فتح العلامة؛
• معدل متابعة الأسئلة؛
• الوقت لتحقيق نتيجة مفيدة؛
• الادخار أو سعر المشاركة؛
• التحويل المصب؛
• معدل العائد لمدة سبعة أيام بين المستخدمين الذين أكملوا إجراء خريطة مدفوع بالدردشة.

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

قائمة تحقق لاختبار الإنتاج

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

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

أخطاء التنفيذ الشائعة

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

Mapbox أم Google Maps أم MapLibre: أيها تختار؟

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

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

قائمة التحقق النهائية للتنفيذ

• تم تأكيد سير عمل الخريطة الحالية
• تم تأكيد المعرض المدعوم
• تحميلات خريطة المزود بنجاح
• تقييد اعتماد مقدم الخدمة
• خطة Kaleidr والوصول المؤكد
• مفتاح قابل للنشر تم إنشاؤه
• تم تأكيد نطاق ai
• الأصول المسموح بتكوينها
• مفتاح الخادم مستبعد من كود المتصفح
• kaleidr.js محملة مرة واحدة
• مثيل الخريطة الحية التي تنتقل إلى Kaleidr.mount
• دورة حياة الدردشة مرتبطة بدورة حياة التطبيق
• تأكيد إجراءات الخريطة المدعومة
• نظم مصادر الحقيقة الموثقة
• حالات عدم النتائج والخطأ المنفذة
• تنفيذ معالجة الحصص
• أحداث التحليلات المضافة
• استكمال مراجعة الأمان والخصوصية
• اختبار إمكانية الوصول
• اختبار السلوك المحمول
• تم اختبار أسئلة المستخدم الحقيقية

الخلاصة

لا تحتاج Mapbox وGoogle Maps و MapLibre إلى استبدالها لإضافة دردشة AI مدركة للخريطة ، لأن المعرض يستمر في امتلاك عرض الخريطة والسلوك الخاص بالمزود.يستمر تطبيق المضيف في امتلاك المستخدمين والأذونات ومنطق الأعمال وحوكمة البيانات، بينما يضيف Kaleidr طبقة المحادثة التي تحل نية المكان، وتتدفق نتائج الموقع المنظمة، وتؤمر الأماكن، وتنسق إجراءات الخريطة المدعومة.وتبقى المسؤوليتان متميزتين، وهو ما يبقي التكامل قابلاً للتصحيح والأجوبة مرتكزة.

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

أضف تفاعلاً بالذكاء الاصطناعي إلى خريطتك الحالية

قم بتوصيل دردشة Kaleidr بصندوق خرائط أو Google Maps أو خريطة MapLibre التي تقوم بتشغيلها بالفعل ، دون تبديل محرّك العرض الخاص بك.يحتاج SDK الحالي فقط إلى مثيل الخريطة الحية ومفتاح قابل للنشر مقيد المنشأ ، ودعوة جبل متطابقة عبر الثلاثة.قم بإنشاء مفتاح باستخدام نطاق ai ، وأضف أصولك المسموح بها ، وامرر الخريطة إلى Kaleidr.mount.

احصل على مفتاح واجهة برمجة تطبيقات Kaleidr

راجع التنفيذ الكامل

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

اقرأ وثائق المطور

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

هل يمكنني إضافة دردشة بالذكاء الاصطناعي إلى خريطة موجودة؟

نعم.يقبل منتج دردشة Kaleidr مثيل خريطة حية ويقوم حاليًا بتوثيق Mapbox وGoogle Maps و MapLibre ومرفق Leaflet.يبقى المُعَدِّل الموجود مسؤولاً عن عرض الخريطة، ويضيف Kaleidr طبقة المحادثة فوقها.

هل أحتاج إلى استبدال Mapbox أو Google Maps أو MapLibre؟

لا.يمكن للتطبيق المضيف الاحتفاظ بمقدم العرض الحالي ، ويعمل Kaleidr كطبقة تفاعل AI المرفقة بمثيل الخريطة الحية.إن تمرير مثيل الخريطة إلى Kaleidr.mount يكفي - لا يلزم هجرة المُقدمين.

كيف تتصل Kaleidr بخريطة مباشرة؟

قم بتحميل kaleidr.js ، وإنشاء كائن الخريطة المباشر للمزود أو الحصول عليه ، واتصل Kaleidr.mount بمفتاح product: "chat" ، وهو مفتاح قابل للنشر ، ومثيل الخريطة.يقوم Kaleidr تلقائيًا بكشف محرّك العرض المدعوم وينسق العلامات والكاميرا من خلاله.

هل أستخدم مفتاحاً قابلاً للنشر أم مفتاح خادم؟

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

كيف أمنع اختلاق إجابات عن الأماكن؟

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

هل تدفع Kaleidr تكاليف استخدام Mapbox أو Google Maps؟

لا.حساب المزود وحساب Kaleidr منفصلان: يقوم Mapbox أو Google بفواتير المُقدم وخدمات المزود ذات الصلة، ويُصور Kaleidr القدرة على الذكاء الاصطناعي ضد مؤسسة Kaleidr.يطبق كل مزود قيوده وحصصه الخاصة بشكل مستقل.

هل تناسب دردشة الذكاء الاصطناعي كل خريطة؟

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

المراجع

• Google. Load the Maps JavaScript API. Google Maps Platform documentation. Accessed 24 July 2026. https://developers.google.com/maps/documentation/javascript/load-maps-js-api
• Google. Google Maps Platform security guidance. Google Maps Platform documentation. Accessed 24 July 2026. https://developers.google.com/maps/api-security-best-practices
• Kaleidr. Attach Kaleidr AI to a Google map. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/guides/attach-ai-to-google-maps
• Kaleidr. Attach Kaleidr AI to a Mapbox map. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/guides/attach-ai-to-mapbox
• Kaleidr. Attach Kaleidr AI to a MapLibre map. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/guides/attach-ai-to-maplibre
• Kaleidr. Auth & scopes. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/platform-api/auth-and-scopes
• Kaleidr. Chat — attach AI to your map. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/sdk/chat-attach
• Kaleidr. CORS & allowed origins. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/platform-api/cors-and-allowed-origins
• Kaleidr. Get an API key. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/get-an-api-key
• Kaleidr. Pricing & Plans. kaleidr.com. Accessed 24 July 2026. https://kaleidr.com/pricing
• Kaleidr. Quickstart. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/quickstart
• Kaleidr. SSE wire contract. Kaleidr Developer Docs. Accessed 24 July 2026. https://docs.kaleidr.com/platform-api/sse-wire-contract
• Mapbox. Get started with Mapbox GL JS using a CDN. Mapbox GL JS documentation. Accessed 24 July 2026. https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-cdn/
• Mapbox. How to use Mapbox securely. Mapbox Help. Accessed 24 July 2026. https://docs.mapbox.com/help/dive-deeper/how-to-use-mapbox-securely/
• MapLibre. Display a map. MapLibre GL JS documentation. Accessed 24 July 2026. https://maplibre.org/maplibre-gl-js/docs/examples/display-a-map/
• MapLibre. Map event types. MapLibre GL JS API documentation. Accessed 24 July 2026. https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MapEventType/

@misc{kaleidr_chat_attach,
  title  = {Chat — attach AI to your map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 24 July 2026},
  url    = {https://docs.kaleidr.com/sdk/chat-attach}
}

@misc{kaleidr_auth_scopes,
  title  = {Auth \& scopes},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 24 July 2026},
  url    = {https://docs.kaleidr.com/platform-api/auth-and-scopes}
}

@misc{kaleidr_mapbox_guide,
  title  = {Attach Kaleidr AI to a Mapbox map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 24 July 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-mapbox}
}

@misc{kaleidr_google_maps_guide,
  title  = {Attach Kaleidr AI to a Google map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 24 July 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-google-maps}
}

@misc{kaleidr_maplibre_guide,
  title  = {Attach Kaleidr AI to a MapLibre map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 24 July 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-maplibre}
}

@misc{mapbox_cdn_guide,
  title  = {Get started with Mapbox GL JS using a CDN},
  author = {{Mapbox}},
  note   = {Mapbox GL JS documentation; accessed 24 July 2026},
  url    = {https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-cdn/}
}

@misc{google_maps_js_loader,
  title  = {Load the Maps JavaScript API},
  author = {{Google}},
  note   = {Google Maps Platform documentation; accessed 24 July 2026},
  url    = {https://developers.google.com/maps/documentation/javascript/load-maps-js-api}
}

@misc{maplibre_display_map,
  title  = {Display a map},
  author = {{MapLibre}},
  note   = {MapLibre GL JS documentation; accessed 24 July 2026},
  url    = {https://maplibre.org/maplibre-gl-js/docs/examples/display-a-map/}
}