التفاعل مع الخريطة

أحداث واجهة المستخدم

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

هناك نوعان رئيسيان من الأحداث:

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

يعرض كل عنصر من عناصر واجهة برمجة التطبيقات للتعيين الثلاثي الأبعاد مجموعة من الأحداث المُسمّاة التي يمكن لبرنامجك تسجيل أدوات معالجة الأحداث لها وتنفيذ منطق عند وقوع هذه الأحداث باستخدام دالة addEventListener() المُدمَجة. يوضح المثال التالي الأحداث الشائعة التي تم تشغيلها عندما يتفاعل المستخدم مع خريطة ثلاثية الأبعاد.

يوضّح المثال التالي الأحداث التي يتم تشغيلها عندما يتفاعل المستخدِم مع الخريطة:

القيود المفروضة على الكاميرا

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

للاطّلاع على مثال حول طريقة عمل قيود الكاميرا وتنفيذها، يمكنك إلقاء نظرة على العرض التوضيحي.